PMC Editing Wiki

User Tools

Site Tools

Trace: • hiddenselectionsmaterials • buldozer-lighting • layers.cfg • config.bin • clutter • wave2lip • atap • vegetation-objects • eden • cockpit2deditor
falcon4:file_formats:rsc_idx_fileformat

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
falcon4:file_formats:rsc_idx_fileformat [2009/02/07 00:47] – lightningfalcon4:file_formats:rsc_idx_fileformat [2024/07/31 08:52] (current) – links added. snakeman
Line 1: Line 1:
-====== IDX/RSC file pairs======+====== Falcon 4 IDX/RSC file pairs====== 
 + 
 +[[https://www.pmctactical.org/forum/viewforum.php?f=47|Falcon 4.0 Forum]], [[:falcon4|Falcon 4 Home]], [[falcon4:campaign|Falcon 4 Campaign]], [[falcon4:cockpits|Falcon 4 Cockpits]], [[falcon4:database|Falcon 4 Database]], [[falcon4:file_formats|Falcon 4 File Formats]], [[falcon4:srtm|Falcon 4 SRTM Terrain]], [[falcon4:terrain|Falcon 4 Terrain]], [[falcon4:textures|Falcon 4 Textures]], [[falcon4:tools|Falcon 4 Tools]] 
 .RSC files in Falcon are "resource bundles".  A "resource bundle" is a type of file that can contain one or more (embedded) binary files, of varying types.  For example, they can contain images, sounds, and/or miscellaneous binary content.  A single .RSC file can (and often does) contain multiple resources, potentially of mixed type (i.e. a resource bundle file could contain several images, several sounds, and several binary files, all at once).   .RSC files in Falcon are "resource bundles".  A "resource bundle" is a type of file that can contain one or more (embedded) binary files, of varying types.  For example, they can contain images, sounds, and/or miscellaneous binary content.  A single .RSC file can (and often does) contain multiple resources, potentially of mixed type (i.e. a resource bundle file could contain several images, several sounds, and several binary files, all at once).  
  
Line 84: Line 87:
  
 ===== Example Code in C# ===== ===== Example Code in C# =====
-The following C# class (F4Resources.F4ResourceBundleReader) illustrates how to read a Falcon Resource Bundle (.RSC file + .IDX file).  It's not optimized for speed (i.e. it uses SetPixel for setting image colors and it uses Array.Copy for copying raw binary data instead of the faster native memory bit-to-block transfer techniques), but it is more illustrative, as a result. +The following C# class (F4Resources.F4ResourceBundleReader) illustrates how to read a Falcon Resource Bundle (.RSC file + .IDX file) at a low level.  It's not optimized for speed (i.e. it uses SetPixel for setting image colors and it uses Array.Copy for copying raw binary data instead of the faster native memory bit-to-block transfer techniques), but it is more illustrative, as a result. 
-<code language="c#">+<code cpp>
 using System; using System;
 using System.Collections.Generic; using System.Collections.Generic;
Line 291: Line 294:
             }             }
         }         }
-        public int Count+        public int NumResources
         {         {
             get             get
Line 444: Line 447:
 } }
 </code> </code>
 +
 +The next chunk of C# example code shows the above class being used in a Windows Forms application, and illustrates how one might use the class presented in the previous example.
 +<code cpp>
 +using System;
 +using System.Drawing;
 +using System.Windows.Forms;
 +using System.IO;
 +using System.Runtime.InteropServices;
 +
 +namespace WindowsFormsApplication1
 +{
 +    public partial class Form1 : Form
 +    {
 +        public Form1()
 +        {
 +            InitializeComponent();
 +        }
 +
 +        private void button1_Click(object sender, EventArgs e)
 +        {
 +            string resourceBundleIndexPath = @"C:\Microprose\Falcon4\Theaters\Vietnam\art\art\resource\select.idx";
 +            F4Resources.F4ResourceBundleReader resourceBundleReader = new F4Resources.F4ResourceBundleReader();
 +            resourceBundleReader.Load(resourceBundleIndexPath);
 +            for (int i = 0; i < resourceBundleReader.NumResources; i++)
 +            {
 +                Application.DoEvents();
 +                F4Resources.F4ResourceType thisResourceType = resourceBundleReader.GetResourceType(i);
 +                switch (thisResourceType)
 +                {
 +                    case F4Resources.F4ResourceType.Unknown:
 +                        break;
 +                    case F4Resources.F4ResourceType.ImageResource: //read an image resource (you could assign the image to a picturebox, or save it to disk, or whatever)
 +                        Bitmap thisImage = resourceBundleReader.GetImageResource(i);
 +                        break;
 +                    case F4Resources.F4ResourceType.SoundResource: //read and play a sound file (writes sound to a temp file and calls WinAPI PlaySound to play it)
 +                        byte[] thisSound = resourceBundleReader.GetSoundResource(i);
 +                        string tempFile = Path.GetTempFileName();
 +                        try
 +                        {
 +                            using (FileStream fs = new FileStream(tempFile, FileMode.Create))
 +                            {
 +                                fs.Write(thisSound, 0, thisSound.Length);
 +                                fs.Flush();
 +                                fs.Close();
 +                            }
 +                            PlaySound(tempFile, IntPtr.Zero, SoundFlags.SND_FILENAME);
 +                        }
 +                        finally
 +                        {
 +                            try
 +                            {
 +                                new FileInfo(tempFile).Delete();
 +                            }
 +                            catch (IOException)
 +                            {
 +                            }
 +                        }
 +                        break;
 +                    case F4Resources.F4ResourceType.FlatResource:
 +                        byte[] thisFlatResource = resourceBundleReader.GetFlatResource(i);
 +                        break;
 +                    default:
 +                        break;
 +                }
 +            }
 +        }
 +        [Flags]
 +        public enum SoundFlags : int
 +        {
 +            SND_SYNC = 0x0000,  // play synchronously (default) 
 +            SND_ASYNC = 0x0001,  // play asynchronously 
 +            SND_NODEFAULT = 0x0002,  // silence (!default) if sound not found 
 +            SND_MEMORY = 0x0004,  // pszSound points to a memory file
 +            SND_LOOP = 0x0008,  // loop the sound until next sndPlaySound 
 +            SND_NOSTOP = 0x0010,  // don't stop any currently playing sound 
 +            SND_NOWAIT = 0x00002000, // don't wait if the driver is busy 
 +            SND_ALIAS = 0x00010000, // name is a registry alias 
 +            SND_ALIAS_ID = 0x00110000, // alias is a predefined ID
 +            SND_FILENAME = 0x00020000, // name is file name 
 +            SND_RESOURCE = 0x00040004  // name is resource name or atom 
 +        }
 +
 +        [System.Runtime.InteropServices.DllImport("winmm.DLL", EntryPoint = "PlaySound", SetLastError = true, CharSet = CharSet.Unicode, ThrowOnUnmappableChar = true)]
 +        private static extern bool PlaySound(string szSound, System.IntPtr hMod, SoundFlags flags);
 +    }
 +}
 +</code>
 +
falcon4/file_formats/rsc_idx_fileformat.1233967626.txt.gz · Last modified: 2009/02/07 00:47 by lightning
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

All PMC web site download services are temporarily suspended until web site yearly fees have been recovered, want to download addons/mods? Then Support PMC.

If you are grateful for all the work PMC has done in the past 25 years, use Support PMC page.