Import Dialog Lump
The Import Lump Dialog allows you to import any kind of file into a PWAD file – including other PWAD
files. You select a target PWAD to receive all the files selected. This
Dialog does the following old functions (and a lot more): Convert File into PWAD, Convert a WAV File into PWAD, Insert a Lump into a
PWAD. To create a NEW file, just enter the name of the file desired and DeePsea will
confirm that you want to create a new file. Now import the file(s) desired.
Think of the import tool as a super customized grouping command – not limited to any specific type of data. Yes, you can import MP3’s for ZDOOM too.
For those who are experienced with Wintex or NWT, note that DeePsea does not
force any conventions on you. You are 100% in control where ALL lump entries
go. Nothing is assumed and nothing is automatically added. You are in charge,
including adding, moving or deleting the F_START, F_END, S_START, S_END and
similar control entries as applicable for the game you are using. This provides you
total independence from future game developments.
For beginners, please review the topics starting with Graphics in DeePsea’s help and also review the new options available with newer ports such as
BOOM, ZDOOM, LEGACY and any others. They typically make it easier to modify
graphics compared to the original DOOM. You can download KABOOM from our website for
an example of replacing sprites, sounds, textures and flats using the newer
conventions.
DeePsea will MERGE imported PWADs with TEXTUREx and PNAMES lumps into one
TEXTURE1 lump and one PNAMES lump. A complete report of the additions,
replacements and duplicates is produced. The LAST name read always replaces a prior name,
so the order of the PWADs counts. Check your new merged PWAD with the Texture Edit tool to make sure all your
textures have valid sizes.
Dialog Display Content
The left four columns display a list of all the File lumps active (file name,
type of lump, default lump name and size of lump).
The contents of the File Lumps are displayed if you select the first column. The contents of the Target File lumps are displayed if you select
the last (rightmost) column - the list of lumps in the Target PWAD.
Importing lumps copies the data in an existing File and converts/merges them
into a PWAD file containing the files selected as directory entries (lump
names). The files can be any existing file with data in a format usable by
DOOM/HERETIC/HEXEN/STRIFE.
LumpName represents a directory entry name. If you intend to replace a
directory entry with this file, choose an existing directory name.
BMP and PCX files are converted to the DOOM format when written. The transparent color can be set via AUTO Options. WAV and MID files are similarly converted
according to the AUTO settings. The MIDI2MUS program is used to convert from MIDI
to MUS – haven’t checked to see if it runs ok on NT?
You can import any size and resolution graphics (well, limited somewhat by
your system resources). If the size exceeds a width of 1024 or a height of 508,
the image is scaled proportionally to match these maximums. Not all game will
display graphic patches over 512 x 256, so experiment and see what your
favorite engine will support. Write to the various port authors and ask for them to
support larger patches.
Import Lump Dialog Buttons
Auto Options
This button lets you change the way DeePsea converts imported files. The
default settings are shown on the main dialog box.
If you select SND, then all WAV files are converted to the DOOM sound format. The newer DOOM
ports support the WAV file format, so this is only is you use the original DOOM
engine.
If you select MUS, then all MID files are converted to the DOOM MUS format. The newer DOOM
ports support the MID file format, so this is only is you use the original DOOM
engine.
There are two variable TEMPO settings for converting MUS-to-MIDI and for
MIDI-to-MUS. These setting are only used if a format conversion takes place. The
MUS-to-MIDI TEMPO is also used to play the MUS files in the previews. The
default value of MUS-to-MIDI is 89. The default value of MIDI-to-MUS is 140.
The default settings or WAV and MID leave the original media formats in the
form they were received. If you want to convert SND or MUS to WAV and MID,
export them with the desired format first.
The minimum / maximum width and height (X and Y) determine what size the
imported image size will be in the DOOM format. Remember, the scaling is
proportional so these are not absolute sizes. For example to get an imported image to be
at least 128 high, also set the minimum width higher. For example, to get an
imported image size of 32 x 32 to be at least 128 high, also set the width to
128. If the imported image was 64 x 32, you set the minimum width to 256.
The Transparent color is used to determine where there are "holes" in the
image. Images that were not created using the game palette will most likely not
match. You can use the DeePsea Graphic editor feature to load the PWAD with your
new graphics and then Flood fill the areas with the correct transparent color.
You then save the image to a PWAD and then use the Group Save to combine it with whatever PWAD you want. This Import dialog can also
combine any elements desired and may be preferred for more advanced users with a
wide variety of modified data lumps.
One reason to change the transparent color is to match the Wintex "Cyan" color of R0, B255, G255 at the indexed
palette value of 247. This color does not exist in the Doom palette. If you use this color, we suggest you change it
back to the default (press the reset button) if you are converting color depths
greater than 8 or graphics that were not created using the DOOM palette.
Failure to change it back may result in DeePsea color conversion assigning your
"transparent" color and since that’s not a real Doom color not only will it not look at all as you thought it
would but DeePsea will make these areas "transparent".
The Gamma Correction value (-50 to +50 percent) adjusts for differences in luminance. The default is 0. Increase the value
if the image is bright so the color matching will find better matches or
decrease if the image is dark. The result is always mapped back to the original game
palette, so will appear darker again in the game.
When you preview the BMP/PCX graphics in the imported files (left side) the
Auto gamma and transparency settings are used – meaning that’s approximately how the graphic colors will appear. The final result will be
lighter or darker, since you are seeing it in the gamma value chosen. The main
purpose is to get the colors correct.
When you preview the images in the target file, the display gamma setting is
used (set in F5 options). It’s normal and natural to see a shift in intensity after you import the image
and then compare it the converted/imported version with the original. The only
time you won’t see a luminance shifts is if your display gamma is the same value as your
conversion gamma.
Add a File to List
This selects the files to be imported. You can select multiple Files to be
imported all at one time in the Windows OPEN dialog box. Press the shift key+a cursor key and then all the selections have to be one after another. To add or delete
selections press ctrl+left mouse button. Windows presents the files to DeePsea in the reverse order selected – that’s the way Windows works – so if you want them in a certain order, select them
in the reverse order from the desired order . PWAD files do NOT have any
conversion done to the data. All lumps in a PWAD are copied as is and in the same
order.
Delete File from List
If you made a mistake including a file, highlight the file you want to delete
and then press this button.
Clear Files in List
This erases all the entries at once.
Open Target File
Select the PWAD to receive all the lumps selected. If it does not exist, you
can create a new blank PWAD.
Save All Files
All the files listed are imported/merged into the Target file. The files are
inserted at the Target location selected from the rightmost Target list. Just
put the cursor where you want the insert to start. All the new lumps will be
inserted after that location.
If you Import All Files but have no files to import, this functions like the Clean Wad command in other utilities since it writes contiguous data with no wasted
holes. DeePsea automatically always "cleans" a level when saved.
BMP and PCX files are converted to DOOM format graphics according to the
Create Textures or Create Flats state. WAV and MID conversions are performed
according to you AUTO Settings.
Rename Lump
If you have duplicate names, press this button to rename the Imported File
Lump for the line that is highlighted You can not rename WAD file lumps. If you
have a WAD file with lumps that require renaming you can use one of two dialogs.
Either first use this dialog to import as a target and use the Rename Target
button on the right. Or use the Rename-Ins-Delete-Move Lump Names Dialog which
is listed on the same selection where you found this dialog.
Textures-Sprites-Projectiles-Weapons- Flats-IMGZ
This is an exclusive selection that determines the type of graphic conversion
desired. Either the graphics are converted into a format for texures, sprites,
weapons, projectiles, Flats or IMGZ. For sprites, weapons and projectiles, the
x/y offsets are set approximately to the values required. Use the Sprite
editor to make final adjustments.
To create different types of graphics, Save your current files, then "Clear
Files", change the type, select more graphics, save and so on.
Flats are always 64x64 and the graphic is automatically resized to this size,
shrinking or stretching the graphic as required. If you have a graphic that is
not symmetrical that you want to make a Flat, you may want to resize the image
first, otherwise the stretching may not be what you intended!
Target Directory Buttons
These buttons are for quickly catching Target directory naming mistakes and
avoiding name conflicts. The generic Rename/Insert/Move Lump Dialog also lets you
insert Before and After an existing lump.
The changes made to the target directory are NOT active until you use the
Import ALL Files button.
Verify PNAMES
A quick way to verify that all the patches you may have merged with multiple
TEXTUREx and PNAMES now exist in your PWAD. You are asked to supply the IWAD
that your PWAD will be used with. For complete verification, load your new
Target PWAD into DeePsea and use the Texture Edit tool to thoroughly examine your
Textures.
Clear Target File
Erases all the lumps in the target directory. This is useful when you are
experimenting and want to start over.
Rename Target
Rename a lump in the Target Directory
Delete Target
Deletes the lump in the Target Directory
Move Target
Moves a name selected to a different location in the directory
Insert Dummy
For quickly creating required –0- length control information, e.g., F_START or
F_END.
Notes:
- Levels are copied replacing any existing Target level.
- The memory requirement for Importing is a bit greater than for the Group
command, depending primarily on the largest lump size in the Source and Target files
- A backup with the .BAK extension is automatically made of the Target file – so
if something goes wrong, use that to restore to the prior version..
- Any invalid level names are converted to BADxx (xx digits). This includes
lump names reserved for levels that are orphaned in the level. You can delete
these names as appropriate.
- Review the help and other documentation for how the special control names
F_START, F_END, FF_START, FF_END, C_START, C_END, S_START, S_END, etc. work. You
have to know what these elements do or else you may have trouble getting Sprites,
Flats, and special control to work.