LaunchBoxCONTRIBUTORS
On this page

14.1 Beta 1 SDK

This reference documents the current beta SDK. Beta APIs can change before stable.

IPlatformCategory7.10

C#
public interface Unbroken.LaunchBox.Plugins.Data.IPlatformCategory
Provides plugin access to a category in the platform hierarchy.

Properties

BackgroundImagePath 7.10

C#
string BackgroundImagePath { get; }
Gets the selected background image path.

BannerImagePath 7.10

C#
string BannerImagePath { get; }
Gets the selected banner image path.

ClearLogoImagePath 7.10

C#
string ClearLogoImagePath { get; }
Gets the selected clear-logo image path.

DeviceImagePath 7.10

C#
string DeviceImagePath { get; }
Gets the selected device image path.

HideInBigBox 13.1

C#
bool HideInBigBox { get; }
Gets whether the current Big Box visibility rules hide this item.

Name 7.10

C#
string Name { get; }
Gets the display name.

NestedName 8.8

C#
string NestedName { get; set; }
Gets or sets the name used for this item in the platform hierarchy.

Notes 7.10

C#
string Notes { get; set; }
Gets or sets the descriptive notes, which may contain formatting.

SortTitle 7.10

C#
string SortTitle { get; set; }
Gets or sets the alternate title used for sorting.

SortTitleOrTitle 7.10

C#
string SortTitleOrTitle { get; }
Gets the sorting title, falling back to the display title when no sorting title is set.

VideoPath 7.10

C#
string VideoPath { get; set; }
Gets or sets the configured video path.

Methods

GetAllGames 7.10

C#
Unbroken.LaunchBox.Plugins.Data.IGame[] GetAllGames(bool includeHidden, bool includeBroken)
Returns games that satisfy the visibility and media filters.
includeHidden 7.10
Whether to include games marked as hidden.
includeBroken 7.10
Whether to include games marked as broken.

Returns

The matching library games.

GetAllGames 8.2

C#
Unbroken.LaunchBox.Plugins.Data.IGame[] GetAllGames(bool includeHidden, bool includeBroken, bool excludeGamesMissingVideos, bool excludeGamesMissingBoxFrontImage, bool excludeGamesMissingScreenshotImage, bool excludeGamesMissingClearLogoImage, bool excludeGamesMissingBackgroundImage)
Returns games that satisfy the visibility and media filters.
includeHidden 8.2
Whether to include games marked as hidden.
includeBroken 8.2
Whether to include games marked as broken.
excludeGamesMissingVideos 8.2
Whether to exclude games without videos.
excludeGamesMissingBoxFrontImage 8.2
Whether to exclude games without front box images.
excludeGamesMissingScreenshotImage 8.2
Whether to exclude games without screenshots.
excludeGamesMissingClearLogoImage 8.2
Whether to exclude games without clear-logo images.
excludeGamesMissingBackgroundImage 8.2
Whether to exclude games without background images.

Returns

The matching library games.

GetChildren 8.8

C#
System.Collections.Generic.IList<Unbroken.LaunchBox.Plugins.Data.IPlatform> GetChildren()
Returns this item's children in the platform hierarchy.

Returns

The child platforms, categories, and playlists. Playlists return an empty list.

GetGameCount 7.10

C#
int GetGameCount(bool includeHidden, bool includeBroken)
Counts games that satisfy the visibility and media filters.
includeHidden 7.10
Whether to include games marked as hidden.
includeBroken 7.10
Whether to include games marked as broken.

Returns

The number of matching games.

GetGameCount 8.2

C#
int GetGameCount(bool includeHidden, bool includeBroken, bool excludeGamesMissingVideos, bool excludeGamesMissingBoxFrontImage, bool excludeGamesMissingScreenshotImage, bool excludeGamesMissingClearLogoImage, bool excludeGamesMissingBackgroundImage)
Counts games that satisfy the visibility and media filters.
includeHidden 8.2
Whether to include games marked as hidden.
includeBroken 8.2
Whether to include games marked as broken.
excludeGamesMissingVideos 8.2
Whether to exclude games without videos.
excludeGamesMissingBoxFrontImage 8.2
Whether to exclude games without front box images.
excludeGamesMissingScreenshotImage 8.2
Whether to exclude games without screenshots.
excludeGamesMissingClearLogoImage 8.2
Whether to exclude games without clear-logo images.
excludeGamesMissingBackgroundImage 8.2
Whether to exclude games without background images.

Returns

The number of matching games.

GetNewPlatformLogoPath 7.10

C#
string GetNewPlatformLogoPath(string url)
Requests a destination path for a platform logo download.
url 7.10
The source image URL.

Returns

The destination path, or null when this legacy operation is unsupported.

GetNewPlatformVideoPath 7.10

C#
string GetNewPlatformVideoPath(string url)
Builds a video destination path using the item name and the source URL's extension.
url 7.10
The source video URL.

Returns

The destination path for the video.

GetPlatformVideoPath 7.10

C#
string GetPlatformVideoPath(bool fallBackToGameVideos = true, bool allowThemePath = true)
Resolves a video for the platform, category, or playlist.
fallBackToGameVideos 7.10
Whether game videos may be used when no item video is found.
allowThemePath 7.10
Whether videos supplied by the current theme may be used.

Returns

The selected video path, or null when none is available.

HasGames 7.10

C#
bool HasGames(bool includeHidden, bool includeBroken)
Checks whether any games satisfy the visibility and media filters.
includeHidden 7.10
Whether to include games marked as hidden.
includeBroken 7.10
Whether to include games marked as broken.

Returns

Whether at least one matching game exists.

HasGames 8.2

C#
bool HasGames(bool includeHidden, bool includeBroken, bool excludeGamesMissingVideos, bool excludeGamesMissingBoxFrontImage, bool excludeGamesMissingScreenshotImage, bool excludeGamesMissingClearLogoImage, bool excludeGamesMissingBackgroundImage)
Checks whether any games satisfy the visibility and media filters.
includeHidden 8.2
Whether to include games marked as hidden.
includeBroken 8.2
Whether to include games marked as broken.
excludeGamesMissingVideos 8.2
Whether to exclude games without videos.
excludeGamesMissingBoxFrontImage 8.2
Whether to exclude games without front box images.
excludeGamesMissingScreenshotImage 8.2
Whether to exclude games without screenshots.
excludeGamesMissingClearLogoImage 8.2
Whether to exclude games without clear-logo images.
excludeGamesMissingBackgroundImage 8.2
Whether to exclude games without background images.

Returns

Whether at least one matching game exists.