Lynkeos
Instance Methods | List of all members
<LynkeosMovieFileReader> Protocol Reference

Protocol for movie file readers. More...

#import <LynkeosFileReader.h>

Inheritance diagram for <LynkeosMovieFileReader>:
Inheritance graph
[legend]
Collaboration diagram for <LynkeosMovieFileReader>:
Collaboration graph
[legend]

Instance Methods

(u_long) - numberOfFrames
 Returns the number of frames in the movie. More...
 
(NSImage *) - getNSImageAtIndex:
 Returns an NSImage for displaying one movie frame. More...
 
(void) - getImageSample:atIndex:withPrecision:withPlanes:atX:Y:W:H:lineWidth:
 Retrieves one movie frame data for processing. More...
 
(id< LynkeosImageBuffer >) - getCustomImageSampleAtIndex:atX:Y:W:H:
 Retrieves image data in a custom format for calibration.(see hasCustomImageBuffer). More...
 
- Instance Methods inherited from <LynkeosFileReader>
(id) - initWithURL:
 Initializes an instance for reading an URL. More...
 
(void) - imageWidth:height:
 Get the pixel size of the image or movie. More...
 
(u_short) - numberOfPlanes
 Get the number of color planes in this file. More...
 
(void) - getMinLevel:maxLevel:
 Retrieves the minimum and maximum levels for this file. More...
 
(NSDictionary *) - getMetaData
 Get the metadata of this file. More...
 
(BOOL) - canBeCalibratedBy:
 Can image/movie data be calibrated by another reader instance data. More...
 

Additional Inherited Members

- Class Methods inherited from <LynkeosFileReader>
(void) + lynkeosFileTypes:
 Returns the file types handled by that class. More...
 
(BOOL) + hasCustomImageBuffer
 Does this reader provides some custom image buffer class(es) ? More...
 

Detailed Description

Protocol for movie file readers.

It allows the application to access each movie frame data.

Method Documentation

- (id <LynkeosImageBuffer>) getCustomImageSampleAtIndex: (u_long)  index
atX: (u_short)  x
Y: (u_short)  y
W: (u_short)  w
H: (u_short)  h 

Retrieves image data in a custom format for calibration.(see hasCustomImageBuffer).

Parameters
indexThe index of the frame to read.
xX origin of the sample
yY origin of the sample
wWidth of sample
hHeight of sample
Returns
The image data in a custom format class conforming to LynkeosImageBuffer protocol
- (void) getImageSample: (void *const *const)  sample
atIndex: (u_long)  index
withPrecision: (floating_precision_t precision
withPlanes: (u_short)  nPlanes
atX: (u_short)  x
Y: (u_short)  y
W: (u_short)  w
H: (u_short)  h
lineWidth: (u_short)  lineW 

Retrieves one movie frame data for processing.

The (x,y) coordinate system has its origin in the top left corner of the image. The samples shall be ordered left to right, then top to bottom.
Most file formats share this orientation and pixels ordering.

Implementors can use the macro SET_SAMPLE (from LynkeosImageBuffer.h) to fill the output buffer.

Parameters
sampleAn array of buffers to fill with image data
precisionWether the sample buffer shall be filled with floats or doubles
indexThe index of the frame to read.
nPlanesThe number of buffers in the array. It can be 1 (the data shall be converted to monochrome), or 3 (RGB data).
xX origin of the sample
yY origin of the sample
wWidth of sample
hHeight of sample
lineWThe number of samples in each line, as it can be larger than w there may be spare at the end of the lines. This only applies to sample
- (NSImage*) getNSImageAtIndex: (u_long)  index

Returns an NSImage for displaying one movie frame.

Parameters
indexThe index of the frame to read.
Returns
A NSImage built from the image data.
- (u_long) numberOfFrames

Returns the number of frames in the movie.

Returns
The number of movie frames.

The documentation for this protocol was generated from the following file: