Slik legger du til ressursfiler i Delphi-kjørbare filer

Spill og andre typer applikasjoner som bruker multimediefiler som lyder og animasjoner, må enten distribuer de ekstra multimediefilene sammen med applikasjonen eller legg inn filene i kjørbar.

I stedet for å distribuere separate filer til applikasjonens bruk, kan du legge til rå data til applikasjonen din som en ressurs. Du kan deretter hente dataene fra applikasjonen din når det er nødvendig. Denne teknikken er generelt mer ønskelig fordi den kan hindre andre i å manipulere tilleggsfiler.

Denne artikkelen viser deg hvordan du legger inn (og bruker) lydfiler, videoklipp, animasjoner og mer generelt alle slags binære filer i en Delphi-kjørbar. For det mest generelle formålet, vil du se hvordan du setter en MP3-fil inni a Delphi exe.

I "Ressursfiler gjort enkelt"artikkelen ble du presentert for flere eksempler på bruk av bitmapper, ikoner og pekere fra ressurser. Som nevnt i den artikkelen kan vi bruke Image Editor til å lage og redigere ressurser som består av slike filtyper. Når vi nå er interessert i å lagre forskjellige typer (binære) filer i en Delphi-kjørbar, må vi forholde oss til ressursskriptfiler (.rc),

Inkludering av flere binære filer i den kjørbare filen din består av fem trinn:

1. Lag og / eller samle alle filene du ønsker å sette i en exe.
2. Lag en ressursskriptfil (.rc) som beskriver ressursene som brukes av applikasjonen din,
3. Sett sammen ressursskriptfilen (.rc) -filen for å opprette en ressursfil (.res),
4. Koble den kompilerte ressursfilen til programmets kjørbare fil,
5. Bruk individuelt ressurselement.

Det første trinnet skal være enkelt, bare bestemme hvilke filtyper du vil lagre i den kjørbare filen. For eksempel vil vi lagre to .wav-sanger, en .ani-animasjoner og en .mp3-sang.

Før vi går videre, er her noen viktige utsagn om begrensninger når du arbeider med ressurser:

• Laste og losse ressurser er ikke en tidkrevende operasjon. Ressurser er en del av applikasjonens kjørbare fil og lastes samtidig som applikasjonen kjøres.
• Alt (gratis) minne kan brukes når du laster / losser ressurser. Det er med andre ord ingen grenser for antall ressurser som lastes samtidig.
• Naturligvis gjør ressursfiler dobbelt så stort som en kjørbar. Hvis du vil ha mindre kjørbare filer, kan du vurdere å plassere ressurser og deler av prosjektet i et Dynamic Link Library (DLL) eller det mer spesialisert variasjon.

La oss nå se hvordan du oppretter en fil som beskriver ressurser.

En ressursskriptfil er bare en enkel tekstfil med filtypen .rc som viser ressurser. Skriptfilen er i dette formatet:

ResName1 ResTYPE1 ResFileName1
ResName2 ResTYPE2 ResFileName2
...
ResNameX ResTYPEX ResFileNameX
...

RexName angir enten et unikt navn eller en heltallverdi (ID) som identifiserer ressursen. ResType beskriver type ressurs og ResFileName er hele banen og filnavnet til den enkelte ressursfil.

For å opprette en ny ressursskriptfil, gjør du ganske enkelt følgende:

1. Lag en ny tekstfil i prosjektkatalogen.
2. Gi den nytt navn til AboutDelphi.rc.

I filen AboutDelphi.rc har du følgende linjer:

Clock WAVE "c: \ mysounds \ projects \ clock.wav"
MailBeep WAVE "c: \ windows \ media \ newmail.wav"
Cool AVI cool.avi
Intro RCDATA introsong.mp3

Skriptfilen definerer ganske enkelt ressurser. Etter det gitte formatet viser AboutDelphi.rc-skriptet to .wav-filer, en .avi-animasjon og en .mp3-sang. Alle utsagn i en .rc-fil knytter et identifiserende navn, type og filnavn for en gitt ressurs. Det er omtrent et dusin forhåndsdefinerte ressurstyper. Disse inkluderer ikoner, bitmapper, markører, animasjoner, sanger, etc. RCDATA definerer generiske dataressurser. RCDATA lar deg inkludere en rå dataressurs for en applikasjon. Rå dataressurser tillater inkludering av binære data direkte i den kjørbare filen. For eksempel navngir RCDATA-setningen ovenfor programmets binære ressursintro og spesifiserer filen introsong.mp3, som inneholder sangen for den MP3-filen.

Merk: Kontroller at du har alle ressursene du viser i .rc-filen din tilgjengelig. Hvis filene er inne i prosjektkatalogen din, trenger du ikke å ta med det fulle filnavnet. I min .rc-fil er wav-sanger * et sted * på disken, og både animasjonen og MP3-sangen er lokalisert i prosjektets katalog.

For å bruke ressursene som er definert i ressursskriptfilen, må vi kompilere den til en .res-fil med Borlands ressurskompilator. Ressurskompilatoren oppretter en ny fil basert på innholdet i ressursskriptfilen. Denne filen har vanligvis en .res-utvidelse. Delphi-linkeren vil senere formatere .res-filen til en ressursobjektfil og deretter koble den til den kjørbare filen til et program.

Borland's Resource Compiler kommandolinjeverktøy ligger i Delphi Bin-katalogen. Navnet er BRCC32.exe. Bare gå til ledeteksten og skriv brcc32 og trykk Enter. Siden Delphi \ Bin-katalogen er i banen din, aktiveres Brcc32-kompilatoren og viser brukshjelpen (siden den ble kalt uten parametere).

Slik kompilerer du AboutDelphi.rc-filen til en .res-fil kjører denne kommandoen ved ledeteksten (i prosjektskatalogen):

BRCC32 AboutDelphi. RC

Når du kompilerer ressurser, navngir BRCC32 som standard den kompilerte ressursfilen (.RES) med grunnnavnet til .RC-filen og plasserer den i samme katalog som .RC-filen.

Du kan navngi ressursfilen hva du vil, så lenge den har utvidelsen ".RES" og filnavnet uten utvidelsen ikke er det samme som en enhets- eller prosjektfilnavn. Dette er viktig fordi hvert Delphi-prosjekt som kompileres til et program som standard har en ressursfil med samme navn som prosjektfilen, men med utvidelsen .RES. Det er best å lagre filen i samme katalog som prosjektfilen.

Etter at .RES-filen er koblet til den kjørbare filen, kan applikasjonen laste ressursene sine på kjøretid etter behov. For å faktisk bruke ressursen, må du foreta noen få Windows API-anrop.

For å følge artikkelen, trenger du et nytt Delphi-prosjekt med et blank form (standard nye prosjekt). Legg selvfølgelig til {$ R AboutDelphi. RES} -direktiv til hovedformens enhet. Det er endelig tid for å se hvordan du bruker ressurser i en Delphi-applikasjon. Som nevnt ovenfor, for å bruke ressurser som er lagret i en exe-fil, må vi forholde oss til API. Imidlertid kan flere metoder finnes i Delphi hjelpefiler som er "ressurs" aktivert.

Ta for eksempel en titt på LoadFromResourceName metode for et TBitmap-objekt. Denne metoden trekker ut den spesifiserte bitmap-ressursen og tildeler den TBitmap-objekt. Dette er * nøyaktig * hva LoadBitmap API-anrop gjør. Som alltid har Delphi forbedret en API-funksjonskall som passer dine behov bedre.

Nå legger du TMediaPlayer-komponenten til et skjema (navn: MediaPlayer1) og legger til en TButton (knapp 2). La OnClick-hendelsen se ut:

Et mindre * problem * er at applikasjonen lager en MP3-sang på en brukermaskin. Du kan legge til en kode som sletter den filen før applikasjonen avsluttes.

Selvfølgelig kan alle andre typer av en binær fil lagres som en RCDATA-type. TRsourceStream er designet spesielt for å hjelpe oss med å trekke ut en slik fil fra en kjørbar. Mulighetene er uendelige: HTML i en exe, EXE i exe, tom database i en exe, og så videre.