quicktime.std
Class RestrictionSet

java.lang.Object
  |
  +--quicktime.QTObject
        |
        +--quicktime.std.RestrictionSet

All Implemented Interfaces:

InterfaceLib, PrimitivesLib, QuickTimeLib, com.apple.jdirect.SharedLibrary, SharedLibrary

public final class RestrictionSet

extends QTObject

implements QuickTimeLib

The RestrictionSet class implements the corresponding data structure of the Movie Toolbox. QuickTime 6 introduces a group of new APIs that provide a mechanism to preflight operations on content that may be restricted. What this means is that, by utilizing these calls, you can determine which QuickTime functions are restricted for the current movie, that is, which operations will fail. These calls also allow developers to see what restrictions are enforced for a particular version of QuickTime. Previously, in earlier versions of QuickTime, there was no mechanism in place to report restrictions on no save or kiosk movies.

Field Summary

Fields inherited from interface quicktime.jdirect.QuickTimeLib

JDirect_MacOSX, libraryInstance, name

Method Summary

static RestrictionSet	fromMovie(Movie theMovie) Returns the restrictions, if any, specified on a given movie.
int	getClassCount() Returns the information about the restrictions designated by the specified restriction set.
int	getItem(int restrictionClass) Returns the restricted items.
int	getSeed() Returns the information about the restrictions designated by the specified restriction set.
static int	getSupportedRestrictions(int restrictionClass) Use this routine to determine what restrictions are enforced by the currently running version of QuickTime.

Methods inherited from class quicktime.QTObject

disposeQTObject, equals, ID, toString

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

fromMovie

public static RestrictionSet fromMovie(Movie theMovie)
                                throws StdQTException

Returns the restrictions, if any, specified on a given movie.

QuickTime::QTGetMovieRestrictions

Parameters:

theMovie - the movie whose restrictions are returned

Returns:

the RestrictionSet object for given movie

StdQTException

getSupportedRestrictions

public static int getSupportedRestrictions(int restrictionClass)

Use this routine to determine what restrictions are enforced by the currently running version of QuickTime.

QuickTime::QTGetSupportedRestrictions

Returns:

restrictions in force for the class passed.

getClassCount

public int getClassCount()

Returns the information about the restrictions designated by the specified restriction set. If you want to determine all of the restrictions, use this routine to determine the count.

QuickTime::QTRestrictionsGetInfo

getSeed

public int getSeed()

Returns the information about the restrictions designated by the specified restriction set.

QuickTime::QTRestrictionsGetInfo

Returns:

an updated integer value that changes with change to the restrition set

getItem

public int getItem(int restrictionClass)

Returns the restricted items.

QuickTime::QTRestrictionsGetItem

Parameters:

restrictionClass - class of restrictions to be reported: kQTRestrictionClassSave or kQTRestrictionClassEdit

Returns:

integer holding constants that indicate individual restrictions