libAF(3)							     libAF(3)



NAME
  libAF.a - Core AF Library

Header Files
  #include <AF/AFlib.h>

Connection Management

  AFAudioConn *AFOpenAudioConn (char *server)

  void AFCloseAudioConn	(AFAudioConn *aud)

  int (*AFSynchronize) (AFAudioConn *aud, int onoff))()

  int (*AFSetAfterFunction) (AFAudioConn *aud, int (*func)()))()

Audio Handling

  ATime	AFGetTime (AC ac)

  ATime	AFPlaySamples (AC ac, ATime startTime,
					  int nbytes, unsigned char *buf)

  ATime	AFRecordSamples	(AC ac,	ATime startTime, int nbytes,
					  unsigned char	*buf, ABool block)

Audio Contexts

  AC AFCreateAC	(AFAudioConn *aud, ADevice device, unsigned long valuemask,
					  AFSetACAttributes *attributes)

  void AFChangeACAttributes (AC	ac, unsigned long valuemask,
					  AFSetACAttributes *attributes)

  void AFFreeAC	(AC ac)

Event Handling

  int AFEventsQueued (AFAudioConn *aud,	int mode)

  int AFPending	(AFAudioConn *aud)

  void AFIfEvent (AFAudioConn *aud, AFEvent *event_return,
					  ABool	(*predicate)(),	char *arg)

  ABool	AFCheckIfEvent (AFAudioConn *aud, AFEvent *event_return,
					  ABool	(*predicate), char *arg)

  void AFPeekIfEvent (AFAudioConn *aud,	AFEvent	*event_return,
					  ABool	(*predicate)(),	char *arg)

  void AFNextEvent (AFAudioConn	*aud, AFEvent *event)

  void AFSelectEvents (AC ac, long mask)

Telephone

  AC AFCreatePhoneAC (AFAudioConn *aud,	unsigned long valuemask,
					  AFSetACAttributes *attributes)

  int AFDialPhone (AC ac, char *dialstring)

  void AFHookSwitch (AC	ac, int	onoff)

  void AFFlashHook (AC ac, int duration)

  void AFQueryPhone (AC	ac, int	*hs_state, int *loop_state)

I/O Control

  void AFEnableInput (AC ac, AMask mask, AMask *old_state, AMask *new_state)

  void AFDisableInput (AC ac, AMask mask, AMask	*old_state, AMask *new_state)

  void AFEnableOutput (AC ac, AMask mask, AMask	*old_state, AMask *new_state)

  void AFDisableOutput ( AC ac,	AMask mask, AMask *old_state,
					  AMask	*new_state)

  void AFEnablePassThrough (AC ac, ABool change, ABool *old_state,
					  ABool	*new_state)

  void AFDisablePassThrough (AC	ac, ABool change, ABool	*old_state,
					  ABool	*new_state)

  int AFQueryInputGain ( AC ac,	int *min_input_gain, int *max_input_gain)

  int AFQueryOutputGain	( AC ac, int *min_output_gain, int *max_output_gain)

  void AFSetInputGain (	AC ac, int gain)

  void AFSetOutputGain ( AC ac,	int gain)

Access Control

  void AFAddHost(AFAudioConn *aud, AFHostAddress *host)

  void AFAddHosts(AFAudioConn *aud, AFHostAddress *hosts, int n)

  AFHostAddress	*AFListHosts(AFAudioConn *aud, int *nhosts_ret,
					  ABool	*enabled_ret)

  void AFRemoveHost(AFAudioConn	*aud, AFHostAddress *host)

  void AFRemoveHosts(AFAudioConn *aud, AFHostAddress *hosts, int n)

  void AFSetAccessControl(AFAudioConn *aud, int	mode)

  void AFEnableAccessControl(AFAudioConn *aud)

  void AFDisableAccessControl(AFAudioConn *aud)

Properties
  int AFGetProperty(AC ac, AAtom property, long	long_offset,
		      long long_length,	ABool delete, AAtom req_type,
		      AAtom *actual_type_return, int *actual_format_return,
		      unsigned long *nitems_return,
		      unsigned long *bytes_after_return,
		      unsigned char **prop_return)

  AAtom	*AFListProperties(AC ac, int *num_prop_return)

  AFChangeProperty(AC ac, AAtom	property, AAtom	type, int format,
		      int mode,	unsigned char *data, int nelements)

  AFDeleteProperty(AC ac, AAtom	property)

  AAtom	AFInternAtom(AFAudioConn *aud, char *atom_name,	ABool only_if_exists)

  char *AFGetAtomName(AFAudioConn *aud,	AAtom atom)

Error Handling

  int (*AFSetErrorHandler) ((*handler)(AFAudioConn *aud,
					  AFErrorEvent *event))()

  int (*AFSetIOErrorHandler) ((*handler)(AFAudioConn *aud))()

  void AFGetErrorText (AFAudioConn *aud, int code, char	*buffer, int nbytes)

  void AFGetErrorDatabaseText (AFAudioConn *aud, char *name, char *type,
					  char *defaultp, char *buffer,
					  int nbytes)

Miscellaneous

  char *AFAudioConnName	(char *conn)

  void AFFlush(AFAudioConn *aud)

  void AFSync(AFAudioConn *aud,	ABool discard)

  void AFNoOp(AFAudioConn *aud)

  AFDeviceDescriptor *AAudioDeviceDescriptor (AFAudioConn * aud,
					  int dev_index)

  AFree(data)
       void *data;

SEE ALSO
  libAFUtil(3),	AF(1)
  AFOpenAudioConn(3), AFCloseAudioConn(3), AFSynchronize(3)
  AFSetAfterFunction(3), AFGetTime(3), AFPlaySamples(3)
  AFRecordSamples(3), AFCreateAC(3), AFChangeACAttributes(3)
  AFFreeAC(3), AFEventsQueued(3), AFPending(3)
  AFIfEvent(3),	AFCheckIfEvent(3), AFPeekIfEvent(3)
  AFNextEvent(3), AFSelectEvents(3), AFCreatePhoneAC(3)
  AFDialPhone(3), AFHookSwitch(3), AFFlashHook(3)
  AFQueryPhone(3), AFEnableInput(3), AFDisableInput(3)
  AFEnableOutput(3), AFDisableOutput(3), AFEnablePassThrough(3)
  AFDisablePassThrough(3), AFQueryInputGain(3),	AFQueryOutputGain(3)
  AFSetInputGain(3), AFSetOutputGain(3), AFAddHost(3)
  AFAddHosts(3), AFListHosts(3), AFRemoveHost(3)
  AFRemoveHosts(3), AFSetAccessControl(3), AFEnableAccessControl(3)
  AFDisableAccessControl(3), AFGetProperty(3), AFListProperties(3)
  AFChangeProperty(3), AFDeleteProperty(3), AFInternAtom(3)
  AFGetAtomName(3), AFSetErrorHandler(3), AFSetIOErrorHandler(3)
  AFGetErrorText(3), AFGetErrorDatabaseText(3),	AFAudioConnName(3)
  AFFlush(3), AFSync(3), AFNoOp(3)
  AAudioDeviceDescriptor(3), AFree(3)



BUGS
  If you encounter a reproducible bug, please submit a problem report to
  (af-bugs@crl.dec.com).



COPYRIGHT
  Copyright 1990-1994, Digital Equipment Corporation.
  See AF(1) for	a full statement of rights and permissions.

AUTHORS
  Digital Cambridge Research Lab