Foxit PDF SDK
9.1
|
Instance Methods | |
(int) | - addMediaPlayer:player: |
Add a media player object for specified type. More... | |
(void) | - dealloc |
(void) | - enableAutoPlay: |
Set the flag to decide whether the media should automatically play when activated. More... | |
(void) | - enableAutoPlay:opt_type: |
Set the flag to decide whether the media should automatically play when activated. More... | |
(void) | - enableControlBarVisible: |
Set the control bar visibility flag. More... | |
(void) | - enableControlBarVisible:opt_type: |
Set the control bar visibility flag. More... | |
(void) | - enableFloatingWindowCloseButton: |
Set the flag to specify if the floating window should include user interface elements that allow a user to close a floating window. More... | |
(void) | - enableFloatingWindowCloseButton:opt_type: |
Set the flag to specify if the floating window should include user interface elements that allow a user to close a floating window. More... | |
(void) | - enableFloatingWindowTitleBar: |
Set flag to specify if the floating window should have a title bar. More... | |
(void) | - enableFloatingWindowTitleBar:opt_type: |
Set flag to specify if the floating window should have a title bar. More... | |
(void *) | - getCptr |
(FSPDFDictionary *) | - getDict |
Get PDF dictionary of current object. More... | |
(int) | - getFloatingWindowHeight |
Get the height of floating window, in pixels. More... | |
(int) | - getFloatingWindowWidth |
Get the width of floating window, in pixels. More... | |
(FSMediaPlayer *) | - getMediaPlayer:index: |
Get a media player object by index for specified type. More... | |
(int) | - getMediaPlayerCount: |
Get the count of media player objects for specified type. More... | |
(BOOL) | - hasFloatingWindowCloseButton |
Check if the floating window should include user interface elements that allow a user to close a floating window. More... | |
(BOOL) | - hasFloatingWindowTitleBar |
Check if the floating window should have a title bar. More... | |
(BOOL) | - hasMediaClip |
Check if current rendition object contains a media clip. More... | |
(id) | - initWithCptr:swigOwnCObject: |
(id) | - initWithOther: |
Constructor, with another rendition object. More... | |
(id) | - initWithPdf_doc: |
Constructor, with parameters. More... | |
(id) | - initWithPdf_doc:rendition_dict: |
Constructor, with parameters. More... | |
(BOOL) | - isAutoPlay |
Check whether the media should automatically play when activated. More... | |
(BOOL) | - isControlBarVisible |
Check whether to display a player-specific controller user interface (for example, play/pause/stop controls) when playing. More... | |
(BOOL) | - isEmpty |
Check whether current object is empty or not. More... | |
(id) | - NS_UNAVAILABLE |
(void) | - removeMediaPlayer:player: |
Remove a media player object for specified type. More... | |
(void) | - setBackgroundColor:opt_type: |
(void) | - setBackgroundOpacity:opt_type: |
(void) | - setDuration:opt_type: |
(void) | - setFitStyle:opt_type: |
(void) | - setFloatingWindowOffscreenEvent:opt_type: |
(void) | - setFloatingWindowPosition:opt_type: |
(void) | - setFloatingWindowRelatedWindowType:opt_type: |
(void) | - setFloatingWindowResizeType:opt_type: |
(void) | - setFloatingWindowSize:height: |
Set the size of floating window, in pixels. More... | |
(void) | - setFloatingWindowSize:height:opt_type: |
Set the size of floating window, in pixels. More... | |
(void) | - setFloatingWindowTitles:opt_type: |
(void) | - setMediaBaseURL:opt_type: |
(void) | - setMonitorSpecifier:opt_type: |
(void) | - setRepeatCount:opt_type: |
(void) | - setVolume:opt_type: |
(void) | - setWindowType:opt_type: |
Properties | |
unsigned int | backgroundColor |
Get or Set the background color for the rectangle in which the media is being played. More... | |
float | backgroundOpacity |
Get or Set the background opacity. (ignored for full-screen and hidden windows) More... | |
int | duration |
Get or Set the intrinsic duration. More... | |
FSRenditionMediaPlayerFitStyle | fitStyle |
Get or Set the fit style. More... | |
FSRenditionFloatingWindowOffscreenEvent | floatingWindowOffscreenEvent |
Get or Set the event type which specifies what should occur if the floating window is positioned totally or partially offscreen (that is, not visible on any physical monitor). More... | |
FSPosition | floatingWindowPosition |
Get or Set the position where floating window should be positioned to the related window. More... | |
FSRenditionFloatingWindowRelatedWindowType | floatingWindowRelatedWindowType |
Get or Set the window relative type. More... | |
FSRenditionFloatingWindowResizeType | floatingWindowResizeType |
Get or Set the resize type which specifies whether the floating window may be resized by a user. More... | |
NSArray< NSString * > * | floatingWindowTitles |
Get or Set the multi-language text array which provides text to display on the floating window's title bar. More... | |
NSString * | mediaBaseURL |
Get or Set the base URL. More... | |
NSString * | mediaClipContentType |
Get or Set the content type (MIME type) of the media data. More... | |
FSFileSpec * | mediaClipFile |
Get or Set the file specification of the actual media data. More... | |
NSString * | mediaClipName |
Get or Set the name of the media clip, for use in user interface. More... | |
NSArray< NSString * > * | mediaDescriptions |
Get or Set the multi-language text array that provides alternate text descriptions for the media clip data in case it cannot be played. More... | |
FSRenditionMonitorSpecifier | monitorSpecifier |
Get or Set the monitor specifier type value. More... | |
FSRenditionMediaPermission | permission |
Get or Set the media permission. More... | |
NSString * | renditionName |
Get or Set the name. More... | |
int | repeatCount |
Get or Set the repeat count, similar to SMIL's repeatCount attribute. More... | |
int | volume |
Get or Set the volume that specifies the desired volume level as a percentage of recorded volume level. More... | |
FSRenditionWindowType | windowType |
Get or Set the type of window that the media should play in. More... | |
Additional Inherited Members | |
![]() | |
BOOL | swigCMemOwn |
void * | swigCPtr |
Rendition object is used as a media object that specifies what to play, how to play it and where to play it. (For more details, please refer to <PDF Reference 1.7> P758 Section "9.1.2 Renditions", P762 "Media Renditions")
- (int) addMediaPlayer: | (FSRenditionMediaPlayerType) | type | |
player: | (FSMediaPlayer*) | player | |
Add a media player object for specified type.
Usually, a media player object should be only be added to a rendition object with specified media player type. User is not recommended to add the same media player object to different renditions or different media player types of one rendition; otherwise unexpected issues (such as crash) may occur later. If user does not want to construct another media player and set same values, user can clone the dictionary of original media player object and use the cloned dictionary to construct another media player directly.
[in] | type | Media player type. Please refer to values starting from FSRenditionMediaPlayerMustUsed and this should be one of these values. |
[in] | player | A media player object to be added for specified type. If the media player has existed for specified type, this function will return the index of the media player. |
- (void) dealloc |
Reimplemented from FSBase.
- (void) enableAutoPlay: | (BOOL) | is_auto_play |
Set the flag to decide whether the media should automatically play when activated.
[in] | is_auto_play | YES means the media should automatically play when activated, while NO means the media should be initially paused when activated (for example, the first frame is displayed). Relevant only for media that may be paused. |
- (void) enableAutoPlay: | (BOOL) | is_auto_play | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
Set the flag to decide whether the media should automatically play when activated.
[in] | is_auto_play | YES means the media should automatically play when activated, while NO means the media should be initially paused when activated (for example, the first frame is displayed). Relevant only for media that may be paused. |
[in] | opt_type | Media option type. Please refer to values starting from FSRenditionMediaOptionMustBeHonored and this should be one of these values. Default value: FSRenditionMediaOptionBestEffort. |
- (void) enableControlBarVisible: | (BOOL) | is_visible |
Set the control bar visibility flag.
Control bar visibility flag is used to decide whether to display a player-specific controller user interface (for example, play/pause/stop controls) when playing.
[in] | is_visible | YES means to display a player-specific controller user interface, while NO means not to display such user interface. |
- (void) enableControlBarVisible: | (BOOL) | is_visible | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
Set the control bar visibility flag.
Control bar visibility flag is used to decide whether to display a player-specific controller user interface (for example, play/pause/stop controls) when playing.
[in] | is_visible | YES means to display a player-specific controller user interface, while NO means not to display such user interface. |
[in] | opt_type | Media option type. Please refer to values starting from FSRenditionMediaOptionMustBeHonored and this should be one of these values. Default value: FSRenditionMediaOptionBestEffort. |
- (void) enableFloatingWindowCloseButton: | (BOOL) | is_visible |
Set the flag to specify if the floating window should include user interface elements that allow a user to close a floating window.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
[in] | is_visible | YES means the floating window should include user interface elements that allow a user to close a floating window, while NO means the floating window does not need to include such user interface element. |
- (void) enableFloatingWindowCloseButton: | (BOOL) | is_visible | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
Set the flag to specify if the floating window should include user interface elements that allow a user to close a floating window.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
[in] | is_visible | YES means the floating window should include user interface elements that allow a user to close a floating window, while NO means the floating window does not need to include such user interface element. |
[in] | opt_type | Media option type. Please refer to values starting from FSRenditionMediaOptionMustBeHonored and this should be one of these values. Default value: FSRenditionMediaOptionBestEffort. |
- (void) enableFloatingWindowTitleBar: | (BOOL) | is_visible |
Set flag to specify if the floating window should have a title bar.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
[in] | is_visible | YES means the floating window should have a title bar, while NO means the floating window does not need to have a title bar. |
- (void) enableFloatingWindowTitleBar: | (BOOL) | is_visible | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
Set flag to specify if the floating window should have a title bar.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
[in] | is_visible | YES means the floating window should have a title bar, while NO means the floating window does not need to have a title bar. |
[in] | opt_type | Media option type. Please refer to values starting from FSRenditionMediaOptionMustBeHonored and this should be one of these values. Default value: FSRenditionMediaOptionBestEffort. |
- (void*) getCptr |
Reimplemented from FSBase.
- (FSPDFDictionary *) getDict |
Get PDF dictionary of current object.
- (int) getFloatingWindowHeight |
Get the height of floating window, in pixels.
This property is necessary when the windows type is FSRenditionWindowTypeFloating.
- (int) getFloatingWindowWidth |
Get the width of floating window, in pixels.
This property is necessary when the windows type is FSRenditionWindowTypeFloating.
- (FSMediaPlayer *) getMediaPlayer: | (FSRenditionMediaPlayerType) | type | |
index: | (int) | index | |
Get a media player object by index for specified type.
[in] | type | Media player type. Please refer to values starting from FSRenditionMediaPlayerMustUsed and this should be one of these values. |
[in] | index | Index of the media player object to be retrieved. Valid range: from 0 to (count-1). count is returned by function FSRendition::getMediaPlayerCount:. |
- (int) getMediaPlayerCount: | (FSRenditionMediaPlayerType) | type |
Get the count of media player objects for specified type.
[in] | type | Media player type. Please refer to values starting from FSRenditionMediaPlayerMustUsed and this should be one of these values. |
- (BOOL) hasFloatingWindowCloseButton |
Check if the floating window should include user interface elements that allow a user to close a floating window.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
- (BOOL) hasFloatingWindowTitleBar |
Check if the floating window should have a title bar.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
- (BOOL) hasMediaClip |
Check if current rendition object contains a media clip.
- (id) initWithCptr: | (void *) | cptr | |
swigOwnCObject: | (BOOL) | ownCObject | |
Reimplemented from FSBase.
- (id) initWithOther: | (FSRendition*) | other |
Constructor, with another rendition object.
[in] | other | Another rendition object. |
- (id) initWithPdf_doc: | (FSPDFDoc*) | pdf_doc |
Constructor, with parameters.
[in] | pdf_doc | A valid PDF document object. |
- (id) initWithPdf_doc: | (FSPDFDoc*) | pdf_doc | |
rendition_dict: | (FSPDFDictionary*) | rendition_dict | |
Constructor, with parameters.
[in] | pdf_doc | A valid PDF document object. |
[in] | rendition_dict | The PDF dictionary for a rendition object in PDF document represented by parameter pdf_doc. If this is nil that means to construct a new rendition object in PDF document represented by parameter pdf_obj. Default value: nil. |
- (BOOL) isAutoPlay |
Check whether the media should automatically play when activated.
- (BOOL) isControlBarVisible |
Check whether to display a player-specific controller user interface (for example, play/pause/stop controls) when playing.
- (BOOL) isEmpty |
Check whether current object is empty or not.
When the current object is empty, that means current object is useless.
- (id) NS_UNAVAILABLE |
- (void) removeMediaPlayer: | (FSRenditionMediaPlayerType) | type | |
player: | (FSMediaPlayer*) | player | |
Remove a media player object for specified type.
[in] | type | Media player type. Please refer to values starting from FSRenditionMediaPlayerMustUsed and this should be one of these values. |
[in] | player | A media player object to be removed. |
- (void) setBackgroundColor: | (unsigned int) | color | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setBackgroundOpacity: | (float) | opacity | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setDuration: | (int) | duration | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setFitStyle: | (FSRenditionMediaPlayerFitStyle) | fit_style | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setFloatingWindowOffscreenEvent: | (FSRenditionFloatingWindowOffscreenEvent) | offscreen_event | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setFloatingWindowPosition: | (FSPosition) | position | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setFloatingWindowRelatedWindowType: | (FSRenditionFloatingWindowRelatedWindowType) | window_type | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setFloatingWindowResizeType: | (FSRenditionFloatingWindowResizeType) | resize_type | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setFloatingWindowSize: | (int) | width | |
height: | (int) | height | |
Set the size of floating window, in pixels.
This property is necessary when the windows type is FSRenditionWindowTypeFloating.
[in] | width | Width of floating window, in pixels. This value should be larger than 0. |
[in] | height | Height of floating window, in pixels. This value should be larger than 0. |
- (void) setFloatingWindowSize: | (int) | width | |
height: | (int) | height | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
Set the size of floating window, in pixels.
This property is necessary when the windows type is FSRenditionWindowTypeFloating.
[in] | width | Width of floating window, in pixels. This value should be larger than 0. |
[in] | height | Height of floating window, in pixels. This value should be larger than 0. |
[in] | opt_type | Media option type. Please refer to values starting from FSRenditionMediaOptionMustBeHonored and this should be one of these values. Default value: FSRenditionMediaOptionBestEffort. |
- (void) setFloatingWindowTitles: | (NSArray< NSString * > *) | titles | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setMediaBaseURL: | (NSString *) | base_url | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setMonitorSpecifier: | (FSRenditionMonitorSpecifier) | monitor_specifier | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setRepeatCount: | (int) | count | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setVolume: | (int) | volume | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
- (void) setWindowType: | (FSRenditionWindowType) | window_type | |
opt_type: | (FSRenditionMediaOptionType) | opt_type | |
|
readwritenonatomicassign |
Get or Set the background color for the rectangle in which the media is being played.
|
readwritenonatomicassign |
Get or Set the background opacity. (ignored for full-screen and hidden windows)
|
readwritenonatomicassign |
Get or Set the intrinsic duration.
|
readwritenonatomicassign |
Get or Set the fit style.
Fit style (manner) specifies how the player should treat a visual media type that does not exactly fit the rectangle in which it plays.
|
readwritenonatomicassign |
Get or Set the event type which specifies what should occur if the floating window is positioned totally or partially offscreen (that is, not visible on any physical monitor).
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
|
readwritenonatomicassign |
Get or Set the position where floating window should be positioned to the related window.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
Window relative specifies the place to which the floating window should be positioned.
|
readwritenonatomicassign |
Get or Set the window relative type.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
Related window type specifies the place to which the floating window should be positioned.
|
readwritenonatomicassign |
Get or Set the resize type which specifies whether the floating window may be resized by a user.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
|
readwritenonatomiccopy |
Get or Set the multi-language text array which provides text to display on the floating window's title bar.
This property is only useful when the windows type is FSRenditionWindowTypeFloating.
Strings in the multi-language text array are in pair: the first string (ASCII string) in each pair is language identifier and the second string is the caption.
|
readwritenonatomiccopy |
Get or Set the base URL.
Base URL is an absolute URL which is used in resolving any relative URLs found within the media data.
|
readwritenonatomiccopy |
Get or Set the content type (MIME type) of the media data.
Content type specifies the type of the media data represented by file specification. The content type string should conform to the content type specification described in Internet RFC 2045, Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies.
|
readwritenonatomiccopy |
Get or Set the file specification of the actual media data.
|
readwritenonatomiccopy |
Get or Set the name of the media clip, for use in user interface.
|
readwritenonatomiccopy |
Get or Set the multi-language text array that provides alternate text descriptions for the media clip data in case it cannot be played.
Strings in the multi-language text array are in pair: the first string (ASCII string) in each pair is language identifier and the second string is the description.
|
readwritenonatomicassign |
Get or Set the monitor specifier type value.
Monitor specifier is used to specify which monitor in a multi-monitor system a floating or full-screen window should appear on.
|
readwritenonatomicassign |
Get or Set the media permission.
Media permission indicates the circumstances under which it is acceptable to write a temporary file in order to play a media clip.
|
readwritenonatomiccopy |
Get or Set the name.
This name can be used for name tree lookup by JavaSript actions and can also be used in user interface.
|
readwritenonatomicassign |
Get or Set the repeat count, similar to SMIL's repeatCount attribute.
|
readwritenonatomicassign |
Get or Set the volume that specifies the desired volume level as a percentage of recorded volume level.
|
readwritenonatomicassign |
Get or Set the type of window that the media should play in.