home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software of the Month Club 1995 December
/
SOFM_Dec1995.bin
/
pc
/
dos
/
utility
/
smartcd
/
smartcdp.doc
< prev
next >
Wrap
Text File
|
1995-10-31
|
25KB
|
672 lines
░░░░░░░┐ ▒▒┐ ▒▒┐ ▓▓▓▓▓▓▓┐ ███████┐ ▓▓▓▓▓▓▓▓┐ ▒▒▒▒▒▒▒┐ ░░░░░░┐
░░┌────┘ ▒▒▒▒──▒▒▒▒│ ▓▓┌──▓▓│ ██┌──██│ └──▓▓┌──┘ ▒▒┌────┘ ░░┌──░░┐
░░░░░░░┐ ▒▒┌─▒▒┌─▒▒│ ▓▓▓▓▓▓▓│ ███████│ ▓▓│ ▒▒│ ░░│ ░░│
└────░░│ ▒▒│ └─┘ ▒▒│ ▓▓┌──▓▓│ ██┌─██┌┘ ▓▓│ ▒▒│ ░░│ ░░│
░░░░░░░│ ▒▒│ ▒▒│ ▓▓│ ▓▓│ ██│ ███┐ ▓▓│ ▒▒▒▒▒▒▒┐ ░░░░░░┌┘
└──────┘ └─┘ └─┘ └─┘ └─┘ └─┘ └──┘ └─┘ └──────┘ └─────┘
Multi-featured CD Player v3.0 (c)1993,95 by Henrique Avila Vianna
**************************************************************************
G U I A D O U S U A R I O
**************************************************************************
SUMARIO
-------
1. Introducao........................................................ 2
1.1. Caracteristicas do programa.................................... 2
1.2. Requisitos de hardware e software.............................. 3
2. Como usar o SMART CD.............................................. 3
2.1. Instalacao..................................................... 3
2.2. Janela do programa............................................. 3
2.3. Comandos do player............................................. 4
2.4. Arquivos de dados.............................................. 5
2.5. Notas sobre a programacao de faixas............................ 6
2.6. Alterando a hotkey............................................. 6
2.7. Compatibilidade................................................ 6
2.8. Isencao de garantia............................................ 7
3. Politica de distribuicao.......................................... 7
3.1. Arquivos do pacote............................................. 8
4. Registrando....................................................... 8
5. Dados tecnicos.................................................... 8
5.1. Notas de programacao........................................... 8
5.2. Codigos de erro................................................ 9
5.3. Historico do SMART CD.......................................... 9
6. Reconhecimentos...................................................10
6.1. Agradecimentos.................................................10
6.2. Bibliografia...................................................10
7. Outros programas do autor.........................................11
8. Contactando o autor...............................................11
SMART CD v3.0 Guia do Usuario Pagina 1
1. INTRODUCAO
-------------
Eu imagino se os caras que criaram o CD nunca pensaram em guardar o nome
do disco e das faixas no proprio CD, de modo que pudessemos ver no display
do player o que estamos escutando.
Este era o meu objetivo principal quando comecei a escrever este programa,
mas desde entao, o SMART CD recebeu uma serie de outras caracteristicas que
fazem dele hoje o mais completo CD player para DOS.
SMART CD é um programa TSR (Terminate and Stay Resident) que simula um
equipamento de CD player, mas com muitas funcoes estendidas. Basicamente, o
programa permite que voce digite o nome do disco e os titulos das faixas e
entao grava esta informacao no seu disco rigido ou disquete, de modo que ela
possa ser lida na proxima vez que voce usar aquele CD.
Uma vez que voce tenha digitado os nomes das faixas, a funcao List lhe
mostrara os titulos de todas as faixas do disco e voce podera até localizar
uma faixa pelo nome usando a funcao Find!
SMART CD suporta programacao de ate 32 faixas e tambem oferece uma
funcao Shuffle que toca todas as faixas (até o limite de 32) em uma ordem
aleatoria, mas sem repeticao. Faixas podem ser adicionadas ou removidas do
programa mesmo quand o CD ja esta tocando! A funcao Repeat tem dois niveis:
repete a faixa atual ou todo o disco ou programa.
O programa usa caracteres redefinidos da VGA para criar um display
imitando um painel de LEDs e a rotina TSR permite que voce ative o programa
enquanto estiver trabalhando em outra aplicacao.
1.1. CARACTERISTICAS DO PROGRAMA
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "Saiba o que voce esta ouvindo": informa titulo do disco e das faixas!
* Programacao ate 32 faixas.
* Adicione e remova faixas do programa, mesmo durante a reproducao!
* Funcao Shuffle: programacao randomica, sem repeticao de faixas.
* Funcao Repeat com 2 niveis: repete uma faixa ou o disco/programa inteiro.
* Rotina TSR: toca o CD enquanto voce trabalha!
* Belo display semi-grafico em VGA.
NOVO NESTA VERSAO:
* "SMART Tracks"(tm): grava o ultimo programa ativo para cada CD.
* Detecta trilhas de dados automaticamente.
* Avanco e retrocesso rapidos.
* Acesso direto a uma faixa digitando seu numero.
* Auto-start e auto-popup: reproducao instantanea quando voce insere o CD.
* Lista titulos de todas as faixas.
* Localiza uma faixa pelo nome.
* Mostra o tempo restante da faixa e do disco.
* Abre/fecha a gaveta do drive.
* Hotkey configuravel pelo usuario.
SMART CD v3.0 Guia do Usuario Pagina 2
1.2. REQUISITOS DE HARDWARE E SOFTWARE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Estes sao os requisitos minimos para usar o SMART CD:
* IBM PC-AT 286 compativel ou melhor
* Drive de CD-ROM (sem brincadeira!)
* Placa grafica VGA
* MSCDEX 2.1 ou mais recente
* MS-DOS 3.1 ou mais recente
* 35K bytes de memoria livre (usada pelo programa enquanto residente)
2. COMO USAR O SMART CD
-----------------------
2.1. INSTALACAO
~~~~~~~~~~~~~~~
Para rodar o programa, digite:
SMARTCD [/S] [/P] | [/R]
([] indicam parametros opcionais, e | indica um parametro exclusivo)
Chaves de linha de comando:
/S - Liga o AUTO-START. Assim que um CD for inserido no drive a reproducao
tera inicio.
/P - Liga o AUTO-POPUP. Quando um disco for inserido no drive, a janela
do SMART CD aparecera na tela.
/R - Remove da memoria uma copia do SMART CD previamente instalada.
NOTA: voce pode, obviamente, usar ambas as chaves /S e /P para reproducao
e abertura da janela instantaneas (otimo efeito!)
Enquanto residente, SMART CD ocupa aproximadamente 35KB de memoria
convencional, mas ele tambem pode ser carregado na Area de Memoria Superior,
usando o comando LH do DOS.
2.2. JANELA DO PROGRAMA
~~~~~~~~~~~~~~~~~~~~~~~
Pressione a hotkey (CTRL+ENTER é a default, mas voce pode altera-la -
veja secao 2.6) para acessar a janela do programa. Ou, se voce usou a chave
/P, apenas insira um CD no drive e a janela aparecera (legal, hein?!). Note
que a janela somente aparecera no modo texto de 80x25.
SMART CD v3.0 Guia do Usuario Pagina 3
A janela do SMART CD tenta reproduzir, o mais fielmente possivel, o
painel de um CD player comum. Ela consiste de basicamente tres partes:
1. o display principal: aqui voce ve informacoes do disco e suas faixas
(tempo, titulo, etc.) e o estado das funcoes do player (programa, repeat,
etc.);
2. o painel de controle: aqui voce tem os comandos do player - qualquer
comando que aparece na linha inferior é executada pressionando a tecla de
funcao correspondente; para executar os comandos da linha superior, use o
SHIFT junto com a tecla de funcao;
3. o display auxiliar: este é usado para mostrar as faixas programadas
e para saida das funcoes FIND, LIST e JUMP.
2.3. COMANDOS DO PLAYER
~~~~~~~~~~~~~~~~~~~~~~~
[ESC] EXIT (Sair)
Volta ao "prompt" do DOS ou a aplicacao em primeiro plano. O programa
permanece residente.
[01] .. [32] JUMP (Pular)
Use as teclas numericas para indicar o numero de faixa desejada. Nao
disponivel se estiver tocando um programa.
[F1] PLAY/PAUSE (Reproduzir/Pausa)
Inicia a reproducao da faixa atualmente selecionada, ou da primeira faixa
do programa. Enquanto estiver tocando, pressione esta tecla para pausa e
novamente para continuar.
[F2] STOP/CLEAR (Para/Limpa)
Para a reproducao. Se ja estiver parado (pressionada duas vezes) limpa
o programa ativo.
[F3] SKIP BACK (Salta para tras)
Salta para a faixa anterior no disco ou programa.
[SHIFT+F3] REWIND (Retrocesso rapido)
Retrocede rapidamente dentro da faixa.
[F4] SKIP FORWARD (Salta para frente)
Salta para a proxima faixa no disco ou programa.
[SHIFT+F4] FAST FORWARD (Avanco rapido)
Avanca rapidamente dentro da faixa.
[F5] PROGRAM (Programa)
Adiciona a faixa atual ao programa. Use as teclas de SKIP (F3 e F4)
para mudar a faixa atual. Depois que iniciar a tocar um programa, voce
pode selecionar as faixas a serem adicionadas usando as teclas de SELECT
(SHIFT+F5 e SHIFT+F6 - veja abaixo).
SMART CD v3.0 Guia do Usuario Pagina 4
[SHIFT+F5] SELECT PREVIOUS (Seleciona anterior)
Durante a reproducao de um programa, seleciona a faixa anterior para
ser adicionada ao programa.
[F6] DELETE (Remove)
Remove a ultima faixa programada. Funciona mesmo durante a reproducao
do programa, porem ate uma faixa apos a que esta sendo tocada.
[SHIFT+F6] SELECT NEXT (Seleciona proxima)
Durante a reproducao de um programa, seleciona a faixa seguinte para
ser adicionada ao programa.
[F7] REPEAT (Repete)
Muda o estado da funcao repete.
[SHIFT+F7] SHUFFLE (Embaralha)
Cria um programa aleatorio e inicia a reproducao.
[F8] TIME (Tempo)
Alterna entre mostrar o tempo decorrido e o tempo restante. Influi nos
campos "time", "# of trks" e "full time".
[SHIFT+F8] FIND (Localiza)
Localiza uma faixa por qualquer parte de seu nome. Nao disponivel durante
a reproducao de um programa.
[F9] LIST (Lista)
Lista no display auxiliar os nomes de todas as faixas do disco.
[SHIFT+F9] SONG TITLE (Titulo da musica)
Permite voce editar o titulo da faixa atual.
[F10] EJECT (Ejetar)
Abre ou fecha a gaveta do drive de CD-ROM. Obviamente, apenas para os
drives que suportam eject por software.
[SHIFT+F10] DISC TITLE (Titulo do disco)
Permite voce editar o titulo do CD.
2.4. ARQUIVOS DE DADOS
~~~~~~~~~~~~~~~~~~~~~~
Um arquivo de dados sera criado para cada CD que voce usar com o SMART CD.
Estes arquivos sao usados para guardar os titulos do disco e de suas faixas
e eles sao gravados no mesmo diretorio aonde estiver o arquivo SMARTCD.EXE.
O arquivo de dados do CD é criado ou atualizado somente quando voce ejeta
o disco ou quando remove o SMART CD da memoria. Entao, se voce tiver digitado
novas informacoes para um disco, nao esqueca de remover o programa antes de
desligar seu computador.
O formato do arquivo é ligeiramente diferente daquele usado na versao 2.0
do SMART CD, mas arquivos antigos serao reconhecidos e automaticamente
convertidos pelo programa.
SMART CD v3.0 Guia do Usuario Pagina 5
2.5. NOTAS SOBRE A PROGRAMACAO DE FAIXAS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
O ultimo programa ativo tambem é gravado no arquivo de dados do CD, e é
recuperado na proxima vez que voce usar aquele CD. Esta é a assim chamada
funcao "SMART Tracks" e funciona assim: suponha que voce nao concorda com a
ordem na qual algumas faixas estao gravadas no CD, ou que voce definitiva-
mente nao gosta de algumas das musicas - simplesmente programe as faixas
como voce quer e entao ejete o disco para forcar o SMART CD a gravar o
arquivo de dados. Insira novamente o disco e voce vera que o player entra
automaticamente no modo programado e com o seu programa "perfeito" carregado!
Se voce limpar o programa com F2 (STOP/CLEAR), o programa gravado nao
sera apagado. Esta é uma caracteristica de seguranca que permite que voce
toque o disco no modo normal ou em "shuffle", ou ainda que voce experimente
uma programacao diferente de faixas sem perder o seu programa "bom". Para
efetivamente apagar o programa do arquivo de dados, voce deve apagar as
faixas programadas uma a uma usando F6 (DEL).
Quando ha um programa ativo, os campos "# of trks" e "full time" mostram
o numero de trilhas e o tempo total do programa, e nao do disco todo.
2.6. ALTERANDO A HOTKEY
~~~~~~~~~~~~~~~~~~~~~~~
A hotkey default para acessar a janela do SMART CD é CTRL+ENTER. Um
utilitario de definicao de hotkey foi incluido no pacote para permitir que
voce escolha uma combinacao de teclas alternativa, no caso de ter outro
programa TSR que use a mesma hotkey.
Basta rodar o programa HOTKEY e entao pressionar a combinacao desejada.
Note que voce deve usar uma ou mais teclas de modificacao (CTRL, ALT, SHIFT)
e mais uma tecla normal. Algumas teclas como CAPS LOCK, F11, F12 e
combinacoes como CTRL+TAB, CTRL+NUM5 nao sao reconhecidas pelo programa.
Apos voce escolher e confirmar a nova hotkey, o programa reescrevera
o arquivo SMARTCD.EXE, de modo que as alteracoes terao efeito na proxima
vez que voce instalar o SMART CD.
2.7. COMPATIBILIDADE
~~~~~~~~~~~~~~~~~~~~
Como voce sabe, o MS-DOS nao é um ambiente multi-tarefa, de modo que
ele nao tem um bom suporte a aplicacoes concorrentes. Programas TSR rodam
em um segundo plano, usando interrupcoes de hardware para obter a atencao
do processador periodicamente. Estes programas sao como intrusos no sistema
e podem eventualmente nao funcionar como esperado.
SMART CD v3.0 Guia do Usuario Pagina 6
Esta versao passou por intensivas etapas de alfa e beta-teste, mas nao
existe software completamente livre de erros e o seu comportamento pode
variar de maquina para maquina, de modo que eu sugeriria que VOCE fizesse
alguns testes antes de usar o programa. Tente instalar o SMART CD e rodar
as aplicacoes que voce usa mais frequentemente; se o seu sistema nao trancar
provavelmente voce nao tera nenhum outro problema.
Alem disso, dois ou mais programas TSR podem ser incompativeis entre si,
entao se voce tiver problemas tente remover todos os TSRs desnecessarios
enquanto estiver usando o SMART CD.
2.8. ISENCAO DE GARANTIA
~~~~~~~~~~~~~~~~~~~~~~~~
***************************************************************************
* O AUTOR NAO SERA RESPONSAVEL, EM HIPOTESE ALGUMA, POR QUAISQUER DANOS *
* CAUSADOS EM HARDWARE E/OU SOFTWARE PELO USO DESTE PROGRAMA OU PELA *
* INCAPACIDADE DO USUARIO EM OPERA-LO CORRETAMENTE. *
***************************************************************************
3. POLITICA DE DISTRIBUICAO
---------------------------
SMART CD é distribuido como SHAREWARE. Dedique algum tempo para
experimenta-lo e se voce decidir usa-lo regularmente, entao por favor pague
a pequena taxa de registro, sao apenas $10 (isso ai, so dez dolares ou o
equivalente na nossa moeda forte!). Por favor, consulte a secao 4 deste
manual para maiores informacoes sobre como registrar.
Voce pode (e é encorajado a) copiar o programa e distribui-lo para quem
quiser (amigos ou inimigos!), desde que nao cobre nada por isso e desde que
todos os arquivos do pacote (veja abaixo) sejam distribuidos juntos, sem
modificacoes, na sua forma descompactada ou compactados juntos por qualquer
compressor de arquivos popular em um unico arquivo chamado SMRTCD30.??? (a
extensao do arquivo sera dada pelo compactador).
Se voce pretende incluir este programa em um pacote de Shareware ou em
qualquer pacote comercial, voce deve obter uma autorizacao minha por escrito
(eu geralmente darei permissao se receber uma copia gratuita do pacote).
Por favor, veja como entrar em contato comigo no final deste arquivo.
SMART CD v3.0 Guia do Usuario Pagina 7
3.1. ARQUIVOS DO PACOTE
~~~~~~~~~~~~~~~~~~~~~~~
O pacote completo do SMART CD 3.0 consiste dos seguintes arquivos:
Nome Tamanho Descricao
------------------------------------------------------------------
SMARTCD EXE 24.784 O programa em si
SMARTCD DOC 23.581 Arquivo de documentacao em ingles
SMARTCDP DOC 25.012 Arquivo de documentacao em portugues
SMARTCD REG 1.997 Formulario de registro em ingles
SMARTCDP REG 2.015 Formulario de registro em portugues
HOTKEY EXE 8.048 Utilitario de definicao de hotkey
REGISTER EXE 7.680 Utilitario de registro de shareware
LED COM 4.195 Bonus: um redefinidor de caracteres VGA
LED TXT 308 Breve descricao do LED.COM
Por favor, assegure-se de que todos estes arquivos sejam distribuidos
juntos.
4. REGISTRANDO
--------------
Se voce gostar do SMART CD voce deve registra-lo para apoiar os esforcos
do autor e motiva-lo a continuar desenvolvendo software de qualidade como
este.
Se voce registrar, voce recebera sua propria "Registration ID" que lhe
permitira personalizar sua copia do SMART CD com seu nome ao inves da
mensagem "UNREGISTERED COPY" (seus amigos morrerao de inveja!).
Note que a versao shareware distribuida gratuitamente é a versao
completamente funcional, nao ha funcoes desabilitadas. O conceito de
"Crippleware" nao faz meu estilo e eu entendo que voce nao pode pagar por
uma determinada caracteristica que voce nao pode testar. Esta é a ideia
do Shareware - experimente antes de comprar.
Registrar o SMART CD é facil: simplesmente imprima o arquivo SMARTCD.REG,
preencha os espacos, inclua sua taxa de registro (apenas $10) e envie pelo
correio. Assim que eu recebe-lo, enviarei sua Registration ID por correio
normal ou correio eletronico.
5. DADOS TECNICOS
-----------------
5.1. NOTAS DE PROGRAMACAO
~~~~~~~~~~~~~~~~~~~~~~~~~
SMART CD foi originalmente escrito no Turbo Pascal 5.5 da Borland. A
versao 3.0 foi escrita no TP 7.0, usando codigo de 16 bits (80286).
SMART CD v3.0 Guia do Usuario Pagina 8
Alem do programa principal, bibliotecas para funcoes personalizadas de
E/S (teclado e video), funcoes de CD Audio de para controle de TSR tambem
foram desenvolvidas. A coisa toda consiste em mais de 3.000 linhas de codigo
fonte.
A versao 3.0 esteve durante seis meses em desenvolvimento e testes antes
de ser lancada ao publico em geral.
5.2. CODIGOS DE ERRO
~~~~~~~~~~~~~~~~~~~~
SMART CD retorna os seguintes codigos de erro:
ERRORLEVEL Problema
----------------------------------------------------------
0 Instalado ou removido sem problemas.
1 MSCDEX nao instalado.
2 Tentativa de instalar quando ja residente.
4 Tentativa de remover quando nao residente.
8 Opcao de linha de comando desconhecida.
5.3. HISTORICO DO SMART CD
~~~~~~~~~~~~~~~~~~~~~~~~~~
Version 1.0 - 18/Abr/93
Primeira versao. Implementadas as rotinas basicas de um
CD player e programacao mesmo enquanto tocando.
Version 2.0 - 28/Ago/93
Primeiro lancamento publico.
Rotina TSR implementada.
Novo display semi-grafico em VGA.
Programacao de faixas melhorada - agora tambem remove
faixas.
Funcao Repeat em dois niveis implementada.
Version 3.0 - 03/Set/95
Corrigido problema na troca de CDs.
Grava ultimo programa ativo para cada CD.
Detecta trilhas de dados automaticamente.
Novas opcoes auto-start e auto-popup.
Novas funcoes: ffwd, rewind, jump, time, list, find, eject.
Novo formato do arquivo de dados para reduzir chances de
repeticao.
Novo visual!
Novos utilitarios: definicao da hotkey e registro de
shareware.
Programa bonus LED.COM adicionado ao pacote.
Beta-testes intensivos.
Muitas otimizacoes no codigo.
Compilado com Turbo Pascal 7.0 usando codigo de 286.
Documentacao completamente revisada e reescrita.
SMART CD v3.0 Guia do Usuario Pagina 9
6. RECONHECIMENTOS
------------------
Esta secao é dedicada a reconhecer as pessoas que contribuiram direta ou
indiretamente na elaboracao do SMART CD. Sem estas pessoas, SMART CD nao
seria o mesmo, ou nao seria sequer real.
6.1. AGRADECIMENTOS
~~~~~~~~~~~~~~~~~~~
Agradeco aos beta-testers do SMART CD:
Antonio Vianna (meu pai) e
Todd Aiken (de Quebec, Canada)
pelo apoio durante o (longo) tempo de desenvolvimento do SMART CD v3.0
e por me fornecerem valiosas sugestoes, ideias e informacoes sobre o
comportamento do programa.
Tambem gostaria de agradecer a Michael J. Mefford pelo seu excelente
utilitario FONTEDIT, que usei para criar as fontes do SMART CD.
6.2. BIBLIOGRAFIA
~~~~~~~~~~~~~~~~~
MICROSOFT MS-DOS CD-ROM Extensions - Hardware-Dependent Device Driver
Specification (Document Number: 000080010-100-O00-1186). Microsoft
Corp., 1990.
YALLOUZ, Carlos. Programas residentes no IBM PC. Rio de Janeiro: Livros
Tecnicos e Cientificos, 1991.
QUADROS, Daniel G.A. PC Assembler; usando o BIOS. Rio de Janeiro: Campus,
1989.
NORTON, Peter & WILTON, Richard. Novo guia Peter Norton para programadores
do IBM PC e PS/2. Rio de Janeiro: Campus, 1991.
SMART CD v3.0 Guia do Usuario Pagina 10
7. OUTROS PROGRAMAS DO AUTOR
----------------------------
Estes sao outros programas do autor de SMART CD que valem a pena voce
dar uma olhada:
Capture It! - Capturador de telas graficas para as placas Hercules, CGA,
(DOS) EGA, MCGA, VGA e SVGA (em breve). Usando um sistema
temporizado exclusivo, ele captura telas que outros
"grabbers" simplesmente nao conseguem. Voce pode converter
as telas capturadas em arquivos GIF.
Disponivel por FTP anonimo para oak.oakland.edu e seus
mirrors em SimTel/msdos/screen/captur22.zip.
Cuckoo - Um autentico relogio cuco no seu desktop! Cuckoo for
(WIN) Windows possui sons digitalizados de um relogio cuco de
verdade! Veja as horas e ouca o passarinho cantar a cada
meia hora. De um toque classico ao seu desktop com Cuckoo
for Windows!
Disponivel por FTP anonimo para oak.oakland.edu e seus
mirrors em SimTel/win3/clock/cuckoo21.zip.
8. CONTACTANDO O AUTOR
----------------------
Lembre-se: SMART CD é Shareware. Eu gostaria de continuar trabalhando
nele, melhorando-o e adicionando novos recursos, mas isso so sera possivel
se eu receber um retorno satisfatorio deste lancamento.
Se voce gostou deste programa, por favor envie seu formulario de
registro!
Seus comentarios, sugestoes e relatorios de problemas tambem sao bem-
vindos. Eles poderao ser aproveitados em uma proxima versao.
Escreva para:
HENRIQUE AVILA VIANNA
RUA ARMANDO SICA 55
96020-140 PELOTAS, RS
BRASIL
Ou, por e-mail, para: snoopy@ufpel.tche.br
Se voce tiver problemas com o endereco acima, tente um destes enderecos
alternativos:
hvianna@brufpel.bitnet (somente ate jan/96)
hvianna@vortex.ufrgs.br
SMART CD v3.0 Guia do Usuario Pagina 11