Modify header.
[Functions operating on pfspd header]

---

Detailed Description

Note: These modifications are not possible after the header is written.

Note: Only the most commonly used modifications are possible with these routines. It is always possible to directly modify the header in the cases that more that just the provided modifications are required.

Functions
pT_status	p_mod_num_frames (pT_header *header, int num_frames)
pT_status	p_mod_color_format (pT_header *header, pT_color color_format)
pT_status	p_mod_aspect_ratio (pT_header *header, pT_asp_rat ratio)
pT_status	p_mod_to_progressive (pT_header *header)
pT_status	p_mod_to_interlaced (pT_header *header)
pT_status	p_mod_to_dbl_image_rate (pT_header *header)
pT_status	p_mod_to_onehalf_image_rate (pT_header *header)
pT_status	p_mod_image_size (pT_header *header, int width, int height)
pT_status	p_mod_defined_image_size (pT_header *header, pT_size image_size, int pixels_per_line)
pT_status	p_mod_all_freqs (pT_header *header, double image_freq, double line_freq, double pixel_freq)
pT_status	p_mod_defined_image_freq (pT_header *header, pT_freq image_freq)
pT_status	p_mod_file_data_format (pT_header *header, pT_data_fmt file_data_fmt)
pT_status	p_mod_file_description (pT_header *header, char *description)

---

Function Documentation

pT_status p_mod_num_frames (  pT_header *  header, int  num_frames )

Change number of frames to num_frames.

pT_status p_mod_color_format (  pT_header *  header, pT_color  color_format )

Change color format to color_format.

pT_status p_mod_aspect_ratio (  pT_header *  header, pT_asp_rat  ratio )

Change aspect ratio to ratio.

pT_status p_mod_to_progressive (  pT_header *  header  )

p_mod_to_progressive : Change header to progressive format.

pT_status p_mod_to_interlaced (  pT_header *  header  )

Change header to interlaced format.

pT_status p_mod_to_dbl_image_rate (  pT_header *  header  )

Double the image rate (e.g. from 50 to 100 Hz). Note that the number of frames in the file is doubled. Operates only on P_50HZ, P_60HZ or P_REAL_60HZ image rates!

pT_status p_mod_to_onehalf_image_rate (  pT_header *  header  )

Image rate times 1.5 (e.g. from 50 to 75 Hz). Note that the number of frames in the file is multiplied with 1.5. Operates only on P_50HZ, P_60HZ or P_REAL_60HZ image rates!

pT_status p_mod_image_size (  pT_header *  header, int  width, int  height )

Change image size to width and height.

pT_status p_mod_defined_image_size (  pT_header *  header, pT_size  image_size, int  pixels_per_line )

Change image size to defined image_size. Image size as specified in image_size & pixels_per_line. If pixels_per_line is zero, a default value of pixels per line will be set. Only the following mage frequencies are supported: P_50HZ, P_60HZ, P_REAL_60HZ, P_24HZ, P_REAL_24HZ, P25HZ, P_30HZ & P_REAL_30HZ.

pT_status p_mod_all_freqs (  pT_header *  header, double  image_freq, double  line_freq, double  pixel_freq )

Change image-, line-, and pixel frequencies. This is useful for "unknown" frequencies or sizes that cannot be handled by p_mod_defined_image_freq and p_mod_defined_image_size.

pT_status p_mod_defined_image_freq (  pT_header *  header, pT_freq  image_freq )

Change image size to defined image_freq. Only the following mage frequencies are supported: P_50HZ, P_60HZ, P_REAL_60HZ, P_24HZ, P_REAL_24HZ, P25HZ, P_30HZ & P_REAL_30HZ. Only standar size images can be changed: P_SD, P_CIF, P_QCIF, P_HDp & P_HDi. If p_get_image_size() returns P_UNKNOWN_SIZE a modification is not possible.

pT_status p_mod_file_data_format (  pT_header *  header, pT_data_fmt  file_data_fmt )

Change the data format of the image.

pT_status p_mod_file_description (  pT_header *  header, char *  description )

Change the file description.

---