Public Member Functions | |
Rendition (const PDFDoc &pdf_doc, objects::PDFDictionary *rendition_dict=0) | |
Constructor, with parameters. More... | |
Rendition (const Rendition &other) | |
Constructor, with another rendition object. More... | |
~Rendition () | |
Destructor. | |
int | AddMediaPlayer (MediaPlayerType type, const MediaPlayer &player) |
Add a media player object for specified type. More... | |
void | EnableAutoPlay (bool is_auto_play, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Check whether the media should automatically play when activated. More... | |
void | EnableControlBarVisible (bool is_visible, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the control bar visibility flag. More... | |
void | EnableFloatingWindowCloseButton (bool is_visible, MediaOptionType opt_type=e_MediaOptionBestEffort) |
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 (bool is_visible, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set flag to specify if the floating window should have a title bar. More... | |
RGB | GetBackgroundColor () const |
Get the background color for the rectangle in which the media is being played. More... | |
float | GetBackgroundOpacity () const |
Get the background opacity. (ignored for full-screen and hidden windows) More... | |
objects::PDFDictionary * | GetDict () const |
Get PDF dictionary of current object. More... | |
int | GetDuration () const |
Get the intrinsic duration. More... | |
MediaPlayerFitStyle | GetFitStyle () const |
Get the fit style. More... | |
int | GetFloatingWindowHeight () const |
Get the height of floating window, in pixels. More... | |
FloatingWindowOffscreenEvent | GetFloatingWindowOffscreenEvent () const |
Get 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... | |
common::Position | GetFloatingWindowPosition () const |
Get the position where floating window should be positioned to the related window. More... | |
FloatingWindowRelatedWindowType | GetFloatingWindowRelatedWindowType () const |
Get the window relative type. More... | |
FloatingWindowResizeType | GetFloatingWindowResizeType () const |
Get the resize type which specifies whether the floating window may be resized by a user. More... | |
WStringArray | GetFloatingWindowTitles () const |
Get the multi-language text array which provides text to display on the floating window's title bar. More... | |
int | GetFloatingWindowWidth () const |
Get the width of floating window, in pixels. More... | |
String | GetMediaBaseURL () const |
Get the base URL. More... | |
String | GetMediaClipContentType () const |
Get the content type (MIME type) of the media data. More... | |
FileSpec | GetMediaClipFile () const |
Get the file specification of the actual media data. More... | |
WString | GetMediaClipName () const |
Get the name of the media clip, for use in user interface. More... | |
WStringArray | GetMediaDescriptions () const |
Get the multi-language text array that provides alternate text descriptions for the media clip data in case it cannot be played. More... | |
MediaPlayer | GetMediaPlayer (MediaPlayerType type, int index) const |
Get a media player object by index for specified type. More... | |
int | GetMediaPlayerCount (MediaPlayerType type) const |
Get the count of media player objects for specified type. More... | |
MonitorSpecifier | GetMonitorSpecifier () const |
Get the monitor specifier type value. More... | |
MediaPermission | GetPermission () const |
Get the media permission. More... | |
WString | GetRenditionName () const |
Get the name. More... | |
int | GetRepeatCount () const |
Get the repeat count, similar to SMIL's repeatCount attribute. More... | |
int | GetVolume () const |
Get the volume that specifies the desired volume level as a percentage of recorded volume level. More... | |
WindowType | GetWindowType () const |
Get the type of window that the media should play in. More... | |
bool | HasFloatingWindowCloseButton () const |
Check if the floating window should include user interface elements that allow a user to close a floating window. More... | |
bool | HasFloatingWindowTitleBar () const |
Check if the floating window should have a title bar. More... | |
bool | HasMediaClip () const |
Check if current rendition object contains a media clip. More... | |
bool | IsAutoPlay () const |
Check whether the media should automatically play when activated. More... | |
bool | IsControlBarVisible () const |
Check whether to display a player-specific controller user interface (for example, play/pause/stop controls) when playing. More... | |
bool | IsEmpty () const |
Check whether current object is empty or not. More... | |
bool | operator!= (const Rendition &other) const |
Not equal operator. More... | |
Rendition & | operator= (const Rendition &other) |
Assign operator. More... | |
bool | operator== (const Rendition &other) const |
Equal operator. More... | |
void | RemoveMediaPlayer (MediaPlayerType type, const MediaPlayer &player) |
Remove a media player object for specified type. More... | |
void | SetBackgroundColor (RGB color, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the background color for the rectangle in which the media is being played. More... | |
void | SetBackgroundOpacity (float opacity, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the background opacity. (ignored for full-screen and hidden windows) More... | |
void | SetDuration (int duration, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the intrinsic duration. More... | |
void | SetFitStyle (MediaPlayerFitStyle fit_style, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the fit style. More... | |
void | SetFloatingWindowOffscreenEvent (FloatingWindowOffscreenEvent offscreen_event, MediaOptionType opt_type=e_MediaOptionBestEffort) |
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... | |
void | SetFloatingWindowPosition (common::Position position, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the position where floating window should be positioned to the related window. More... | |
void | SetFloatingWindowRelatedWindowType (FloatingWindowRelatedWindowType window_type, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the window relative type. More... | |
void | SetFloatingWindowResizeType (FloatingWindowResizeType resize_type, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the resize type which specifies whether the floating window may be resized by a user. More... | |
void | SetFloatingWindowSize (int width, int height, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the size of floating window, in pixels. More... | |
void | SetFloatingWindowTitles (const WStringArray &titles, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the multi-language text array which provides text to display on the floating window's title bar. More... | |
void | SetMediaBaseURL (const String &base_url, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the base URL. More... | |
void | SetMediaClipContentType (const char *content_type) |
Set the content type (MIME type) of the media data. More... | |
void | SetMediaClipFile (FileSpec file_specification) |
Set the file specification of the actual media data. More... | |
void | SetMediaClipName (const WString &name) |
Set the name of the media clip, for use in user interface. More... | |
void | SetMediaDescriptions (const WStringArray &description_array) |
Set the multi-language text array that provides alternate text descriptions for the media clip data in case it cannot be played. More... | |
void | SetMonitorSpecifier (MonitorSpecifier monitor_specifier, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the monitor specifier type value. More... | |
void | SetPermission (MediaPermission permission) |
Set the media permission. More... | |
void | SetRenditionName (const WString &name) |
Get the name. More... | |
void | SetRepeatCount (int count, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the repeat count, similar to SMIL's repeatCount attribute. More... | |
void | SetVolume (int volume, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the volume that specifies the desired volume level as a percentage of recorded volume level. More... | |
void | SetWindowType (WindowType window_type, MediaOptionType opt_type=e_MediaOptionBestEffort) |
Set the type of window that the media should play in. More... | |
![]() | |
FS_HANDLE | Handle () const |
Get the handle of current object. More... | |
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")
Enumeration for offscreen event type of floating window.
Values of this enumeration should be used alone.
Offscreen event type is used to specifies what should occur if the floating window is positioned totally or partially offscreen (that is, not visible on any physical monitor).
Enumerator | |
---|---|
e_FloatingWindowOffscreenEventNone | Nothing. |
e_FloatingWindowOffscreenEventMoveResize | Move or resize. |
e_FloatingWindowOffscreenEventNonViable | Consider the object non-viable. |
Enumeration for the type of floating window's related window.
Values of this enumeration should be used alone.
Related window type specifies the place to which the floating window should be positioned.
Enumeration for resize type of floating window.
Values of this enumeration should be used alone.
Enumeration for media option type.
Values of this enumeration should be used alone.
Please refer to <PDF reference 1.7> P757 Section "9.1.1 Viability" for more details.
Enumeration for PDF media player permission.
Values of this enumeration should be used alone.
Media permission indicates the circumstances under which it is acceptable to write a temporary file in order to play a media clip.
Enumeration for the fit style.
Values of this enumeration should be used alone.
Fit style (manner) specifies how the player should treat a visual media type that does not exactly fit the rectangle in which it plays.
Enumeration for PDF media player classified type.
Values of this enumeration should be used alone.
Enumeration for monitor specifier type.
Values of this enumeration should be used alone.
Monitor specifier is used to specify which monitor in a multi-monitor system a floating or full-screen window should appear on.
Enumeration for the type of window that the media should play in.
Values of this enumeration should be used alone.
foxit::pdf::Rendition::Rendition | ( | const PDFDoc & | pdf_doc, |
objects::PDFDictionary * | rendition_dict = 0 |
||
) |
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 NULL that means to construct a new rendition object in PDF document represented by parameter pdf_obj. Default value: NULL. |
foxit::pdf::Rendition::Rendition | ( | const Rendition & | other | ) |
Constructor, with another rendition object.
[in] | other | Another rendition object. |
int foxit::pdf::Rendition::AddMediaPlayer | ( | MediaPlayerType | type, |
const MediaPlayer & | 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 Rendition::e_MediaPlayerMustUsed 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 foxit::pdf::Rendition::EnableAutoPlay | ( | bool | is_auto_play, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Check whether the media should automatically play when activated.
[in] | is_auto_play | true means the media should automatically play when activated, while false 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 Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::EnableControlBarVisible | ( | bool | is_visible, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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 | true means to display a player-specific controller user interface, while false means not to display such user interface. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::EnableFloatingWindowCloseButton | ( | bool | is_visible, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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 Rendition::e_WindowTypeFloating.
[in] | is_visible | true means the floating window should include user interface elements that allow a user to close a floating window, while false 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 Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::EnableFloatingWindowTitleBar | ( | bool | is_visible, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set flag to specify if the floating window should have a title bar.
This property is only useful when the windows type is Rendition::e_WindowTypeFloating.
[in] | is_visible | true means the floating window should have a title bar, while false means the floating window does not need to have a title bar.. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
RGB foxit::pdf::Rendition::GetBackgroundColor | ( | ) | const |
Get the background color for the rectangle in which the media is being played.
float foxit::pdf::Rendition::GetBackgroundOpacity | ( | ) | const |
Get the background opacity. (ignored for full-screen and hidden windows)
objects::PDFDictionary* foxit::pdf::Rendition::GetDict | ( | ) | const |
Get PDF dictionary of current object.
int foxit::pdf::Rendition::GetDuration | ( | ) | const |
Get the intrinsic duration.
MediaPlayerFitStyle foxit::pdf::Rendition::GetFitStyle | ( | ) | const |
Get 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.
int foxit::pdf::Rendition::GetFloatingWindowHeight | ( | ) | const |
Get the height of floating window, in pixels.
This property is necessary when the windows type is Rendition::e_WindowTypeFloating.
FloatingWindowOffscreenEvent foxit::pdf::Rendition::GetFloatingWindowOffscreenEvent | ( | ) | const |
Get 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 Rendition::e_WindowTypeFloating.
common::Position foxit::pdf::Rendition::GetFloatingWindowPosition | ( | ) | const |
Get the position where floating window should be positioned to the related window.
This property is only useful when the windows type is Rendition::e_WindowTypeFloating.
Window relative specifies the place to which the floating window should be positioned.
FloatingWindowRelatedWindowType foxit::pdf::Rendition::GetFloatingWindowRelatedWindowType | ( | ) | const |
Get the window relative type.
This property is only useful when the windows type is Rendition::e_WindowTypeFloating.
Related window type specifies the place to which the floating window should be positioned.
FloatingWindowResizeType foxit::pdf::Rendition::GetFloatingWindowResizeType | ( | ) | const |
Get 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 Rendition::e_WindowTypeFloating.
WStringArray foxit::pdf::Rendition::GetFloatingWindowTitles | ( | ) | const |
Get 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 Rendition::e_WindowTypeFloating.
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.
int foxit::pdf::Rendition::GetFloatingWindowWidth | ( | ) | const |
Get the width of floating window, in pixels.
This property is necessary when the windows type is Rendition::e_WindowTypeFloating.
String foxit::pdf::Rendition::GetMediaBaseURL | ( | ) | const |
Get the base URL.
Base URL is an absolute URL which is used in resolving any relative URLs found within the media data.
String foxit::pdf::Rendition::GetMediaClipContentType | ( | ) | const |
Get 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.
FileSpec foxit::pdf::Rendition::GetMediaClipFile | ( | ) | const |
Get the file specification of the actual media data.
WString foxit::pdf::Rendition::GetMediaClipName | ( | ) | const |
Get the name of the media clip, for use in user interface.
WStringArray foxit::pdf::Rendition::GetMediaDescriptions | ( | ) | const |
Get 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.
MediaPlayer foxit::pdf::Rendition::GetMediaPlayer | ( | MediaPlayerType | type, |
int | index | ||
) | const |
Get a media player object by index for specified type.
[in] | type | Media player type. Please refer to values starting from Rendition::e_MediaPlayerMustUsed 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 Rendition::GetMediaPlayerCount. |
int foxit::pdf::Rendition::GetMediaPlayerCount | ( | MediaPlayerType | type | ) | const |
Get the count of media player objects for specified type.
[in] | type | Media player type. Please refer to values starting from Rendition::e_MediaPlayerMustUsed and this should be one of these values. |
MonitorSpecifier foxit::pdf::Rendition::GetMonitorSpecifier | ( | ) | const |
Get 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.
MediaPermission foxit::pdf::Rendition::GetPermission | ( | ) | const |
Get 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.
WString foxit::pdf::Rendition::GetRenditionName | ( | ) | const |
Get the name.
This name can be used for name tree lookup by JavaSript actions and can also be used in user interface.
int foxit::pdf::Rendition::GetRepeatCount | ( | ) | const |
Get the repeat count, similar to SMIL's repeatCount attribute.
int foxit::pdf::Rendition::GetVolume | ( | ) | const |
Get the volume that specifies the desired volume level as a percentage of recorded volume level.
WindowType foxit::pdf::Rendition::GetWindowType | ( | ) | const |
Get the type of window that the media should play in.
bool foxit::pdf::Rendition::HasFloatingWindowCloseButton | ( | ) | const |
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 Rendition::e_WindowTypeFloating.
bool foxit::pdf::Rendition::HasFloatingWindowTitleBar | ( | ) | const |
Check if the floating window should have a title bar.
This property is only useful when the windows type is Rendition::e_WindowTypeFloating.
bool foxit::pdf::Rendition::HasMediaClip | ( | ) | const |
Check if current rendition object contains a media clip.
bool foxit::pdf::Rendition::IsAutoPlay | ( | ) | const |
Check whether the media should automatically play when activated.
bool foxit::pdf::Rendition::IsControlBarVisible | ( | ) | const |
Check whether to display a player-specific controller user interface (for example, play/pause/stop controls) when playing.
bool foxit::pdf::Rendition::IsEmpty | ( | ) | const |
Check whether current object is empty or not.
When the current object is empty, that means current object is useless.
bool foxit::pdf::Rendition::operator!= | ( | const Rendition & | other | ) | const |
Not equal operator.
[in] | other | Another rendition object. This function will check if current object is not equal to this one. |
Assign operator.
[in] | other | Another rendition object, whose value would be assigned to current object. |
bool foxit::pdf::Rendition::operator== | ( | const Rendition & | other | ) | const |
Equal operator.
[in] | other | Another rendition object. This function will check if current object is equal to this one. |
void foxit::pdf::Rendition::RemoveMediaPlayer | ( | MediaPlayerType | type, |
const MediaPlayer & | player | ||
) |
Remove a media player object for specified type.
[in] | type | Media player type. Please refer to values starting from Rendition::e_MediaPlayerMustUsed and this should be one of these values. |
[in] | player | A media player object to be removed. |
void foxit::pdf::Rendition::SetBackgroundColor | ( | RGB | color, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the background color for the rectangle in which the media is being played.
[in] | color | Background color to set. Format: 0xRRGGBB. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetBackgroundOpacity | ( | float | opacity, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the background opacity. (ignored for full-screen and hidden windows)
[in] | opacity | Background opacity. Valid range: 0.0 to 1.0. 0.0 means full transparency and 1.0 means full opaque. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetDuration | ( | int | duration, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the intrinsic duration.
[in] | duration | Intrinsic duration value to set. It should be:
|
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFitStyle | ( | MediaPlayerFitStyle | fit_style, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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.
[in] | fit_style | Fit style value. Please refer to values starting from Rendition::e_MediaPlayerFitStyleMeet and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFloatingWindowOffscreenEvent | ( | FloatingWindowOffscreenEvent | offscreen_event, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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 Rendition::e_WindowTypeFloating.
[in] | offscreen_event | Event type for offscreen situation of floating window. Please refer to values starting from Rendition::e_FloatingWindowOffscreenEventNone and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFloatingWindowPosition | ( | common::Position | position, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the position where floating window should be positioned to the related window.
This property is only useful when the windows type is Rendition::e_WindowTypeFloating.
Window relative specifies the place to which the floating window should be positioned.
[in] | position | Window relative type. Please refer to values starting from Rendition::e_FloatingWindowRelatedWindowDocument and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFloatingWindowRelatedWindowType | ( | FloatingWindowRelatedWindowType | window_type, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the window relative type.
This property is only useful when the windows type is Rendition::e_WindowTypeFloating.
Related window type specifies the place to which the floating window should be positioned.
[in] | window_type | Related window type. Please refer to values starting from Rendition::e_FloatingWindowRelatedWindowDocument and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFloatingWindowResizeType | ( | FloatingWindowResizeType | resize_type, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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 Rendition::e_WindowTypeFloating.
[in] | resize_type | Resize type. Please refer to values starting from Rendition::e_FloatingWindowResizeTypeNo and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFloatingWindowSize | ( | int | width, |
int | height, | ||
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the size of floating window, in pixels.
This property is necessary when the windows type is Rendition::e_WindowTypeFloating.
[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 Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetFloatingWindowTitles | ( | const WStringArray & | titles, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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 Rendition::e_WindowTypeFloating.
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.
[in] | titles | A string array that represents multi-language text array. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetMediaBaseURL | ( | const String & | base_url, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the base URL.
Base URL is an absolute URL which is used in resolving any relative URLs found within the media data.
[in] | base_url | The base URL to set. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetMediaClipContentType | ( | const char * | content_type | ) |
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.
User is recommended to set the content type when setting a new file specification by function Rendition::SetMediaClipFile.
[in] | content_type | Content type (MIME type). |
void foxit::pdf::Rendition::SetMediaClipFile | ( | FileSpec | file_specification | ) |
Set the file specification of the actual media data.
This property is necessary for a rendition object. And user is recommended to set the content type by function Rendition::SetMediaClipContentType after setting a new file specification.
[in] | file_specification | A file specification object. |
void foxit::pdf::Rendition::SetMediaClipName | ( | const WString & | name | ) |
Set the name of the media clip, for use in user interface.
[in] | name | Name string to be set for the media clip. |
void foxit::pdf::Rendition::SetMediaDescriptions | ( | const WStringArray & | description_array | ) |
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.
[in] | description_array | A multi-language text array for description. |
void foxit::pdf::Rendition::SetMonitorSpecifier | ( | MonitorSpecifier | monitor_specifier, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
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.
[in] | monitor_specifier | Monitor specifier type value. Please refer to values starting from Rendition::e_MonitorSpecifierLargest and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetPermission | ( | MediaPermission | permission | ) |
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.
[in] | permission | Media permission value. Please refer to values starting from Rendition::e_MediaPermTempNever and this should be one of these values. |
void foxit::pdf::Rendition::SetRenditionName | ( | const WString & | name | ) |
Get the name.
This name can be used for name tree lookup by JavaSript actions and can also be used in user interface.
[in] | name | Name of current rendition object. |
void foxit::pdf::Rendition::SetRepeatCount | ( | int | count, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the repeat count, similar to SMIL's repeatCount attribute.
[in] | count | The repeat count to be set. 0 means repeat forever. This value should not be negative value. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetVolume | ( | int | volume, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the volume that specifies the desired volume level as a percentage of recorded volume level.
[in] | volume | Volume value to set. 0 means mute. This value should not be negative. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |
void foxit::pdf::Rendition::SetWindowType | ( | WindowType | window_type, |
MediaOptionType | opt_type = e_MediaOptionBestEffort |
||
) |
Set the type of window that the media should play in.
[in] | window_type | Windows type value. Please refer to values starting from Rendition::e_WindowTypeFloating and this should be one of these values. |
[in] | opt_type | Media option type. Please refer to values starting from Rendition::e_MediaOptionMustBeHonored and this should be one of these values. Default value: Rendition::e_MediaOptionBestEffort. |