Brew Utilities Guide

QUALCOMM Incorporated 5775 Morehouse Drive San Diego, CA. 92121-1714 U.S.A. This manual was written for use with the BREW SDKTM for Windows, software version 1.1.0. This manual and the BREW SDK software described in it are copyrighted, with all rights reserved. This manual and the BREW SDK software may not be copied, except as otherwise provided in your software license or as expressly permitted in writing by QUALCOMM Incorporated. Copyright  2001 QUALCOMM Incorporated All Rights Reserved Printed in the United States of America. All data and information contained in or disclosed by this document are confidential and proprietary information of QUALCOMM Incorporated, and all rights therein are expressly reserved. By accepting this material, the recipient agrees that this material and the information contained therein are held in confidence and in trust and will not be used, copied, reproduced in whole or in part, nor its contents revealed in any manner to others without the express written permission of QUALCOMM Incorporated. Export of this technology may be controlled by the United States Government. Diversion contrary to U.S. law prohibited. Binary Runtime Environment for Wireless, BREW, BREW SDK, TRUE BREW, BREWStone, MobileShop, Eudora, and PureVoice are trademarks of QUALCOMM Incorporated. QUALCOMM is a registered trademark and registered service mark of QUALCOMM Incorporated. Microsoft, Windows, Visual Studio, and Sound Recorder are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Macintosh is a registered trademark of Apple Computer, Inc. UNIX and X-Windows are trademarks of The Open Group. Adobe, Acrobat, and Photoshop are trademarks of Adobe Systems Incorporated. All trademarks and registered trademarks referenced herein are the property of their respective owners.

BREW SDK Utilities Guide November 26, 2001

Contents Introducing the BREW SDK Utilities Guide, 4 BREW documentation, 4 Requesting new BREW features, 5 For more information, 5

Using the PureVoice Converter, 6 Converting files using the PureVoice Converter, 6 Converting WAV files to mono, 8 kilohertz, 16 bit format, 7

Index, 10

iii

Introducing the BREW SDK Utilities Guide This guide provides an overview of the utilities included with the Binary Runtime Environment for Wireless ™ (BREW ™) Software Development Kit (BREW SDK™). This guide includes the following sections:

Using the PureVoice Converter

Describes how to use this utility to convert pulse code modulation (PCM) waveform (WAV) files to PureVoice QCP files (and vice versa) that can be played on the BREW Emulator, subsequently referred to as the Emulator, and on BREW-enabled devices that support PureVoice.

BREW documentation This guide is part of an information set that includes the following documents:

BREW SDK User’s Guide

Introduces the components of the BREW SDK and their relationship to one another. The document also contains general instructions for developing BREW applications and for using the Emulator.

BREW API Reference

Provides information about BREW functions and data structures needed to develop applications for BREW-enabled mobile platforms.

BREW Device Configurator Guide

Describes how to use the BREW Device Configurator to create effective wireless devices for emulation by the Emulator.

BREW Resource Editor Guide

Describes how to use the BREW Resource Editor to create the text strings, images, and dialogs used by BREW applications.

BREW MIF Editor Guide

Describes how to use the BREW MIF Editor to create and modify Module Information Files (MIF)—a special type of BREW resource file that contains information about the classes and applets supported by particular BREW modules.

4

Introducing the BREW SDK Utilities Guide

BREW SDK Utilities Guide

Describes how to use the utilities, such as the PureVoice Converter, included with the BREW SDK.

BREW Compressed Image Authoring Guide

Describes how to use the BREW Compressed Image Authoring Tool to create files for displaying and animating images in your applications.

Requesting new BREW features Do you have ideas for features that would make the BREW SDK more valuable and useful to you? If so, send us email at [email protected]. Each request is evaluated, and a member of the New Features Response Team will respond to your email.

For more information Online information and support is available for BREW application developers. Please visit the BREW web site for details: www.qualcomm.com/brew/developer.

5

Using the PureVoice Converter PureVoice voice coding technology, developed by QUALCOMM and a standard in CDMA cellular technology, allows your applications to play back incoming speech signals on the Emulator and BREW-enabled devices that support PureVoice. Also included in QUALCOMM Mobile Station Modem (MSM) chipsets and with QUALCOMM’s Eudora software, PureVoice compresses an incoming speech signal to its most compact digital format. It can reduce file size and transmission time by more than a factor of 10, compared to other common formats, such as the WAV format. For more information on PureVoice, see http://www.cdmatech.com/solutions/products/purevoice.html. BREW supports PureVoice files, with the .qcp extension, encoded in IS-733 (13 kilobits per second, variable rate) format. The ISoundPlayer interface can play QCP files, in addition to MIDI and MP3 formats. For more information on the QCP format support by ISoundPlayer, see the BREW API Reference. The Emulator also supports the playback of QCP files. The MIDI sample application, included in the BREW SDK, plays QCP files, in addition to MIDI and MP3 files. You can use the PureVoice Converter, shipped with the BREW SDK, to convert WAV files to QCP files (and vice versa). The QCP files can be tested on the Emulator, and you can play them on BREWenabled handsets using the BREW APIs.

Converting files using the PureVoice Converter The PureVoice Converter converts PCM (mono, 8 Kilohertz, 16 bit) WAV files to PureVoice QCP files (and vice versa) using different encoding modes (variable rate, full fixed, half max variable, and half fixed). If you intend to convert a WAV file that is not already in the mono, 8 kilohertz, 16 bit format, you must first convert it to that format. See Converting WAV files to mono, 8 kilohertz, 16 bit format on page 7 for instructions. NOTE: BREW supports only IS-733 (13 kilobits per second, variable rate) encoding only.

To convert a WAV file to QCP (or vice versa) 1. Open the Windows command prompt.

6

Using the PureVoice Converter

2. Access the directory where the WAV or QCP file to be converted resides. NOTE: The directory contains several WAV and QCP files with which you can experiment. 3. Type the following command: Usage:pvconv [-e {0..3}] infile [outfile]

Where • infile is the WAV or QCP file to be converted. • outfile is the name of the WAV or QCP file after the conversion (optional). • -e (0..3) is the encoding mode for the conversion (-e is optional). The encoding mode options are: -

0: variable rate (default)

-

1: full fixed

-

2: half max variable

-

3: half fixed

4. Press Enter to execute the command and convert the file.

The converted file is stored in the same directory as the original file.

Converting WAV files to mono, 8 kilohertz, 16 bit format Before you can use the PureVoice Converter to convert WAV files to the QCP format, you must first convert them to mono, 8 kilohertz, 16 bit format using the Windows Sound Recorder application.

To convert a WAV file to mono, 8 kilohertz, 16 bit format 1. Choose Start > Programs > Accessories and navigate to the Sound Recorder application. The location of this application is different depending on the Windows operating system you run.

7

Using the PureVoice Converter

The Sound Recorder window opens.

2. Choose File > Open, navigate to the directory where you store your WAV files, and open the WAV file you want to convert. 3. Choose File > Properties.

The Properties dialog box for the selected sound file opens.

4. Check the Audio Format field. If the audio format is anything besides PCM 8 KHz, 16 Bit, Mono, click Convert Now.

8

Using the PureVoice Converter

The Sound Selection dialog box opens.

5. Make the entries shown above, and click Save As.

The Save As window opens.

6. Type BREW QCP, and click OK

The Save As window closes and BREW QCP is added to the list of sounds available in the Sound Selection dialog box.

7. Click OK.

The file is now ready to be converted to QCP format with the PureVoice Converter.

9

Index C Converting sound files, 6

F Features, requesting new, 5

P PureVoice technology, 6 PVConv utility, using, 6

R Requesting new BREW features, 5

S Sound Recorder, 7

W WAV files, converting, 7 Web site, BREW, 5

10