All Channel Function Documentation

TAP_Channel_GetTotalNum

Topfield Documentation

int TAP_Channel_GetTotalNum(int *nTvSvc, int *nRadioSvc)

It gets the number of TV and Radio services.

  • nTvSvc : number of TV services
  • nRadioSvc : number of Radio services
Return value : 0

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetInfo

Topfield Documentation

int TAP_Channel_GetInfo(int chType, int chNum, TYPE_TapChInfo *chInfo)

It gets the information of the specified channel.

  • chType : Type of channel. It is defined in Tap.h.
  • chNum : Channel number.
  • chInfo : Channel information.
Return value : If 1, there is no error.

Additional Documentation

Despite the Topfield documentation, the return code is 1 if there is no error.

Also "chNum" is not the logical channel number, it is a number from 0..(MAX_TV_SERVICES-1) or 0..(MAX_RADIO_SERVICES-1) indexing into the PVRs internal table of channels.

The "tunerNum" information does not refer to the tuner in use, but (I think) to whether each tuner detected the channel at the last relevant scan.

The "freq" information does not seem to have any direct relationship to the RF frequency - this can be obtained with FireBird's "Flash" extensions.

EMJB

TAP_Channel_GetCurrent

Topfield Documentation

int TAP_Channel_GetCurrent(int *tvRadio, int* chNum)

It gets the service type and number of the current service.

  • tvRadio : Channel type.
  • chNum : Channel Number.
Return value : current channel number

Additional Documentation

Add any additional documentation here.

TAP_Channel_Start

Int TAP_Channel_Start(int mainSub, int chType, int chNum)

It changes the current service to the specified channel.

  • mainSub : 1 = main screen, 0 = sub screen.
  • chType : Channel type.
  • chNum : Channel number.
Return value : If 0, there is no errors.

Additional Documentation

chNum can also be -1 to start the last channel that was active.

TAP_Channel_Scale

int TAP_Channel_Scale(int mainSub, long x, long y, long w, long h, bool anim)

It changes the size of screen.

  • mainSub : 1 = main screen, 0 = sub screen.
  • x, y : upper-left coordinate of the screen.
  • w,h : width and height of the screen.
  • anim : if TRUE, it is scaled smoothly.
Return value : If 0, there is no errors.

Additional Documentation

Add any additional documentation here.

TAP_Channel_IsPlayable

int TAP_Channel_IsPlayable(int mainSub, int chType, int chNum)

It checks the specified channel whether it is possible to decode.

  • mainSub : 1 = main screen, 0 = sub screen.
  • chType : Channel type.
  • chNum : Channel number.
Return value : If 0, there is no errors.

Additional Documentation

It checks whether the specified channel can be played.

Return values: 0 (yes), 1 (yes - but other tuner), 2 (no)

TAP_Channel_Move

int TAP_Channel_Move(int mainSub, int dir)

It moves the current channel.

  • mainSub : 1 = main screen, 0 = sub screen.
  • dir : direction of zapping. (-1 = decrease channel number, 1 = increase channel number).
Return value : If 0, there is no errors.

Additional Documentation

Add any additional documentation here.

TAP_Channel_Stop

int TAP_Channel_Stop(int mainSub)

It stops the current channel.

  • mainSub : 1 = main screen, 0 = sub screen.
Return value : If 0, there is no errors.

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetTotalAudioTrack

Int TAP_Channel_GetTotalAudioTrack(void)

It gets the number of audio tracks.

Return value : the number of audio tracks.

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetAudioTrackName

char *TAP_Channel_GetAudioTrackName(int trkNum, char *trkName)

It gets the name of specified audio track.

  • trkNum : audio track number.
  • trkName : the pointer of specified audio track name. It must be allocated or NULL. In case of NULL, only.
Return value : the pointer of specified audio track name

Additional Documentation

Add any additional documentation here.

TAP_Channel_SetAudioTrack

Int TAP_Channel_SetAudioTrack(int trkNum)

It changes the current audio track.

  • trkNum : audio track number.
Return value : If 0, there is no errors.

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetTotalSubtitleTrack

int TAP_Channel_GetTotalSubtitleTrack(void)

It gets the number of subtitle track.

Return value : the number of subtitle track.

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetSubtitleTrackName

char *TAP_Channel_GetSubtitleTrackName(int trkNum, char *trkName)

It gets the name of specified subtitle track.

  • trkNum : audio track number.
  • trkName : the pointer of specified subtitle track name. It must be allocated or NULL. In case of NULL, only return value has the pointer of the subtitle track name.
Return value : the pointer of specified subtitle track name

Additional Documentation

Add any additional documentation here.

TAP_Channel_SetSubtitleTrack

int TAP_Channel_SetSubtitleTrack(int trkNum)

It change the current subtitle track.

  • trkNum : subtitle track number.
Return value : If 0, there is no errors.

Additional Documentation

EMJB: R2-D2 has found that if you give it 0xFFFF as the trkNum then it turns off subtitles. As well as changing the system setting, it has a call to set the subtitle PID (and other things).

TAP_Channel_IsStarted

bool TAP_Channel_IsStarted(int mainSub);

It checks whether the service started or not.

  • mainSub : 1 = main screen, 0 = sub screen.
Return value : TRUE = Service started, FALSE = Not started.

Additional Documentation

You can use CHANNEL_Main or CHANNEL_Sub in place of hard coded values for the mainSub parameter.

TAP_Channel_GetCurrentSubTV

int TAP_Channel_GetCurrentSubTV(int *svcNum);

It gets the service number of sub-screen in PIP.

  • svcNum : Service number.
Return value : 0

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetFirstInfo

int TAP_Channel_GetFirstInfo(int svcType, TYPE_TapChInfo *chInfo);

It gets the channel information of the first service in the current TP.

  • svcType : 1 = Radio service, 0 = TV service.
  • chInfo : Channel information.
Return value : Total number of services in the current TP.

Additional Documentation

Add any additional documentation here.

TAP_Channel_GetNextInfo

int TAP_Channel_GetNextInfo(TYPE_TapChInfo *chInfo);

It gets the channel information of the next service in the current TP.

  • chInfo : Channel information.
Return value : If 0, there is no more service. If 1, there is a service.

Additional Documentation

Add any additional documentation here.