17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 57c478bd9Sstevel@tonic-gate * Common Development and Distribution License, Version 1.0 only 67c478bd9Sstevel@tonic-gate * (the "License"). You may not use this file except in compliance 77c478bd9Sstevel@tonic-gate * with the License. 87c478bd9Sstevel@tonic-gate * 97c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 107c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 117c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 127c478bd9Sstevel@tonic-gate * and limitations under the License. 137c478bd9Sstevel@tonic-gate * 147c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 157c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 167c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 177c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 187c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 197c478bd9Sstevel@tonic-gate * 207c478bd9Sstevel@tonic-gate * CDDL HEADER END 217c478bd9Sstevel@tonic-gate */ 227c478bd9Sstevel@tonic-gate /* 237c478bd9Sstevel@tonic-gate * Copyright (c) 1992-2001 by Sun Microsystems, Inc. 247c478bd9Sstevel@tonic-gate * All rights reserved. 257c478bd9Sstevel@tonic-gate */ 267c478bd9Sstevel@tonic-gate 277c478bd9Sstevel@tonic-gate #ifndef _MULTIMEDIA_AUDIOFILE_H 287c478bd9Sstevel@tonic-gate #define _MULTIMEDIA_AUDIOFILE_H 297c478bd9Sstevel@tonic-gate 307c478bd9Sstevel@tonic-gate #ifdef NO_EXTERN_C 317c478bd9Sstevel@tonic-gate 327c478bd9Sstevel@tonic-gate #ifdef __cplusplus 337c478bd9Sstevel@tonic-gate extern "C" { 347c478bd9Sstevel@tonic-gate #endif 357c478bd9Sstevel@tonic-gate 367c478bd9Sstevel@tonic-gate #endif /* NO_EXTERN_C */ 377c478bd9Sstevel@tonic-gate 387c478bd9Sstevel@tonic-gate #include <AudioUnixfile.h> 397c478bd9Sstevel@tonic-gate #include <sys/types.h> 407c478bd9Sstevel@tonic-gate #include <sys/mman.h> 417c478bd9Sstevel@tonic-gate 427c478bd9Sstevel@tonic-gate // A 'primitive type' for memory mapped file access types 437c478bd9Sstevel@tonic-gate enum vmaccess_t { 447c478bd9Sstevel@tonic-gate NormalAccess = 0, RandomAccess = 1, SequentialAccess = 2 457c478bd9Sstevel@tonic-gate }; 467c478bd9Sstevel@tonic-gate 477c478bd9Sstevel@tonic-gate class VMAccess { 487c478bd9Sstevel@tonic-gate private: 497c478bd9Sstevel@tonic-gate vmaccess_t type; // combined mode 507c478bd9Sstevel@tonic-gate public: type(x)517c478bd9Sstevel@tonic-gate VMAccess(vmaccess_t x = NormalAccess): type(x) { } // Constructor vmaccess_t()527c478bd9Sstevel@tonic-gate inline operator vmaccess_t() // Cast to enum 537c478bd9Sstevel@tonic-gate { return (type); } 547c478bd9Sstevel@tonic-gate inline operator int() { // Cast to integer 557c478bd9Sstevel@tonic-gate switch (type) { 567c478bd9Sstevel@tonic-gate case RandomAccess: return (MADV_RANDOM); 577c478bd9Sstevel@tonic-gate case SequentialAccess: return (MADV_SEQUENTIAL); 58*1146e6b3SToomas Soome case NormalAccess: 59*1146e6b3SToomas Soome default: 60*1146e6b3SToomas Soome return (MADV_NORMAL); 617c478bd9Sstevel@tonic-gate } 627c478bd9Sstevel@tonic-gate } 637c478bd9Sstevel@tonic-gate }; 647c478bd9Sstevel@tonic-gate 657c478bd9Sstevel@tonic-gate 667c478bd9Sstevel@tonic-gate // This is the 'base' class for regular files containing audio data 677c478bd9Sstevel@tonic-gate class AudioFile : public AudioUnixfile { 687c478bd9Sstevel@tonic-gate private: 697c478bd9Sstevel@tonic-gate static const FileAccess defmode; // Default access mode 707c478bd9Sstevel@tonic-gate static const char *AUDIO_PATH; // Default path env name 717c478bd9Sstevel@tonic-gate 727c478bd9Sstevel@tonic-gate off_t hdrsize; // length of file header 737c478bd9Sstevel@tonic-gate off_t seekpos; // current system file pointer 747c478bd9Sstevel@tonic-gate Double origlen; // initial length of file 757c478bd9Sstevel@tonic-gate 767c478bd9Sstevel@tonic-gate caddr_t mapaddr; // for mmaping RO files 777c478bd9Sstevel@tonic-gate off_t maplen; // length of mmaped region 787c478bd9Sstevel@tonic-gate VMAccess vmaccess; // vm (mmap) access type 797c478bd9Sstevel@tonic-gate 807c478bd9Sstevel@tonic-gate AudioFile operator=(AudioFile); // Assignment is illegal 817c478bd9Sstevel@tonic-gate 827c478bd9Sstevel@tonic-gate protected: 837c478bd9Sstevel@tonic-gate // Open named file 847c478bd9Sstevel@tonic-gate virtual AudioError tryopen( 857c478bd9Sstevel@tonic-gate const char *, int); 867c478bd9Sstevel@tonic-gate // Create named file 877c478bd9Sstevel@tonic-gate virtual AudioError createfile( 887c478bd9Sstevel@tonic-gate const char *path); // filename 897c478bd9Sstevel@tonic-gate 907c478bd9Sstevel@tonic-gate // class AudioUnixfile methods specialized here 917c478bd9Sstevel@tonic-gate // Seek in input stream 927c478bd9Sstevel@tonic-gate virtual AudioError seekread( 937c478bd9Sstevel@tonic-gate Double pos, // position to seek to 947c478bd9Sstevel@tonic-gate off_t& offset); // returned byte offset 957c478bd9Sstevel@tonic-gate // Seek in output stream 967c478bd9Sstevel@tonic-gate virtual AudioError seekwrite( 977c478bd9Sstevel@tonic-gate Double pos, // position to seek to 987c478bd9Sstevel@tonic-gate off_t& offset); // returned byte offset 997c478bd9Sstevel@tonic-gate 1007c478bd9Sstevel@tonic-gate public: 1017c478bd9Sstevel@tonic-gate AudioFile(); // Constructor w/no args 1027c478bd9Sstevel@tonic-gate 1037c478bd9Sstevel@tonic-gate // Constructor with path 1047c478bd9Sstevel@tonic-gate AudioFile( 1057c478bd9Sstevel@tonic-gate const char *path, // filename 1067c478bd9Sstevel@tonic-gate const FileAccess acc = defmode); // access mode 1077c478bd9Sstevel@tonic-gate virtual ~AudioFile(); // Destructor 1087c478bd9Sstevel@tonic-gate 1097c478bd9Sstevel@tonic-gate // Set tmpfile location 1107c478bd9Sstevel@tonic-gate static AudioError SetTempPath( 1117c478bd9Sstevel@tonic-gate const char *path); // directory path 1127c478bd9Sstevel@tonic-gate 1137c478bd9Sstevel@tonic-gate // class AudioUnixfile methods specialized here SetBlocking(Boolean)1147c478bd9Sstevel@tonic-gate virtual void SetBlocking(Boolean) { } // No-op for files 1157c478bd9Sstevel@tonic-gate 1167c478bd9Sstevel@tonic-gate // front end to madvise 1177c478bd9Sstevel@tonic-gate AudioError SetAccessType( 1187c478bd9Sstevel@tonic-gate VMAccess vmacc); // (normal, random, seq access) 1197c478bd9Sstevel@tonic-gate GetAccessType()1207c478bd9Sstevel@tonic-gate inline VMAccess GetAccessType() const { // get vm access type 1217c478bd9Sstevel@tonic-gate return (vmaccess); 1227c478bd9Sstevel@tonic-gate } 1237c478bd9Sstevel@tonic-gate 1247c478bd9Sstevel@tonic-gate virtual AudioError Create(); // Create file 1257c478bd9Sstevel@tonic-gate virtual AudioError Open(); // Open file 1267c478bd9Sstevel@tonic-gate 1277c478bd9Sstevel@tonic-gate // ... with search path 1287c478bd9Sstevel@tonic-gate virtual AudioError OpenPath( 1297c478bd9Sstevel@tonic-gate const char *path = AUDIO_PATH); 1307c478bd9Sstevel@tonic-gate virtual AudioError Close(); // Close file 1317c478bd9Sstevel@tonic-gate 1327c478bd9Sstevel@tonic-gate // Read from position 1337c478bd9Sstevel@tonic-gate virtual AudioError ReadData( 1347c478bd9Sstevel@tonic-gate void* buf, // buffer to fill 1357c478bd9Sstevel@tonic-gate size_t& len, // buffer length (updated) 1367c478bd9Sstevel@tonic-gate Double& pos); // start position (updated) 1377c478bd9Sstevel@tonic-gate 1387c478bd9Sstevel@tonic-gate // Write at position 1397c478bd9Sstevel@tonic-gate virtual AudioError WriteData( 1407c478bd9Sstevel@tonic-gate void* buf, // buffer to copy 1417c478bd9Sstevel@tonic-gate size_t& len, // buffer length (updated) 1427c478bd9Sstevel@tonic-gate Double& pos); // start position (updated) 1437c478bd9Sstevel@tonic-gate 1447c478bd9Sstevel@tonic-gate // copy to another audio obj. 1457c478bd9Sstevel@tonic-gate virtual AudioError AsyncCopy( 1467c478bd9Sstevel@tonic-gate Audio* ap, // dest audio object 1477c478bd9Sstevel@tonic-gate Double& frompos, 1487c478bd9Sstevel@tonic-gate Double& topos, 1497c478bd9Sstevel@tonic-gate Double& limit); 1507c478bd9Sstevel@tonic-gate 1517c478bd9Sstevel@tonic-gate // class Audio methods specialized here isFile()1527c478bd9Sstevel@tonic-gate virtual Boolean isFile() const { return (TRUE); } 1537c478bd9Sstevel@tonic-gate }; 1547c478bd9Sstevel@tonic-gate 1557c478bd9Sstevel@tonic-gate #ifdef NO_EXTERN_C 1567c478bd9Sstevel@tonic-gate 1577c478bd9Sstevel@tonic-gate #ifdef __cplusplus 1587c478bd9Sstevel@tonic-gate } 1597c478bd9Sstevel@tonic-gate #endif 1607c478bd9Sstevel@tonic-gate 1617c478bd9Sstevel@tonic-gate #endif /* NO_EXTERN_C */ 1627c478bd9Sstevel@tonic-gate 1637c478bd9Sstevel@tonic-gate #endif /* !_MULTIMEDIA_AUDIOFILE_H */ 164