316
edits
Changes
m
reformatting long lines & makefile
Line 24:
Line 24:
#---------------------------------------------------------------------------------+ # Clear the implicit built in rules+
− #---------------------------------------------------------------------------------+ .SUFFIXES:+ #---------------------------------------------------------------------------------+ ifeq ($(strip $(DEVKITPPC)),)+ $(error "Please set DEVKITPPC in your environment. export DEVKITPPC=<path to>devkitPPC")+ endif+ + include $(DEVKITPPC)/wii_rules+ + #---------------------------------------------------------------------------------+ # TARGET is the name of the output+ # BUILD is the directory where object files & intermediate files will be placed+
− # SOURCES is a list of directories containing source code+ # INCLUDES is a list of directories containing extra header files+ #---------------------------------------------------------------------------------+ TARGET := $(notdir $(CURDIR))+
− BUILD := build+ SOURCES := source+ DATA := data + INCLUDES :=+
− + #---------------------------------------------------------------------------------+ # options for code generation+ #---------------------------------------------------------------------------------+ +
− CFLAGS = -g -O2 -mrvl -Wall $(MACHDEP) $(INCLUDE) -I$(DEVKITPPC)/local/include+ CXXFLAGS = $(CFLAGS)+ LDFLAGS = -g $(MACHDEP) -mrvl -Wl,-Map,$(notdir $@).map+ + #---------------------------------------------------------------------------------+ # any extra libraries we wish to link with the project+
− #---------------------------------------------------------------------------------+ LIBS := -lwiisprite -lpng -lz -lwiiuse -lbte -lfat -logc -lm + + #---------------------------------------------------------------------------------+ # list of directories containing libraries, this must be the top level containing+ # include and lib+ #---------------------------------------------------------------------------------+
− LIBDIRS := + +
− #---------------------------------------------------------------------------------+ # no real need to edit anything past this point unless you need to add additional+ # rules for different file extensions+
− #---------------------------------------------------------------------------------+ ifneq ($(BUILD),$(notdir $(CURDIR)))+
− #---------------------------------------------------------------------------------+ + export OUTPUT := $(CURDIR)/$(TARGET)+ + export VPATH := $(foreach dir,$(SOURCES),$(CURDIR)/$(dir)) \+ $(foreach dir,$(DATA),$(CURDIR)/$(dir))+ + export DEPSDIR := $(CURDIR)/$(BUILD)+ +
− #---------------------------------------------------------------------------------+ # automatically build a list of object files for our project+ #---------------------------------------------------------------------------------+ CFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.c)))+ CPPFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.cpp)))+ sFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.s)))+ SFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.S)))+ BINFILES := $(foreach dir,$(DATA),$(notdir $(wildcard $(dir)/*.*)))+ +
− #---------------------------------------------------------------------------------+ # use CXX for linking C++ projects, CC for standard C+ #---------------------------------------------------------------------------------+ ifeq ($(strip $(CPPFILES)),)+
− export LD := $(CC)+ else+ export LD := $(CXX)+ endif+ + export OFILES := $(addsuffix .o,$(BINFILES)) \+ $(CPPFILES:.cpp=.o) $(CFILES:.c=.o) \+ $(sFILES:.s=.o) $(SFILES:.S=.o)+
− + #---------------------------------------------------------------------------------+ # build a list of include paths+ #---------------------------------------------------------------------------------+ export INCLUDE := $(foreach dir,$(INCLUDES), -iquote $(CURDIR)/$(dir)) \+ $(foreach dir,$(LIBDIRS),-I$(dir)/include) \+
− -I$(CURDIR)/$(BUILD) \+ -I$(LIBOGC_INC)+ +
− #---------------------------------------------------------------------------------+ # build a list of library paths+ #---------------------------------------------------------------------------------+ export LIBPATHS := $(foreach dir,$(LIBDIRS),-L$(dir)/lib) \+ -L$(LIBOGC_LIB) -L$(DEVKITPPC)/local/lib+
− + export OUTPUT := $(CURDIR)/$(TARGET)+ .PHONY: $(BUILD) clean+ + #---------------------------------------------------------------------------------+
− $(BUILD):+ @[ -d $@ ] || mkdir -p $@+ @make --no-print-directory -C $(BUILD) -f $(CURDIR)/Makefile+ +
− #---------------------------------------------------------------------------------+ clean:+ @echo clean ...+ @rm -fr $(BUILD) $(OUTPUT).elf $(OUTPUT).dol+
− +
− #---------------------------------------------------------------------------------+ run:+ psoload $(TARGET).dol+
− + #---------------------------------------------------------------------------------+
− reload:+ psoload -r $(TARGET).dol+ + + #---------------------------------------------------------------------------------+ else+
− + DEPENDS := $(OFILES:.o=.d)+ + #---------------------------------------------------------------------------------+ # main targets+ #---------------------------------------------------------------------------------+ $(OUTPUT).dol: $(OUTPUT).elf+ $(OUTPUT).elf: $(OFILES)+
− + #---------------------------------------------------------------------------------+
− # This rule links in binary data with the .jpg extension+ #---------------------------------------------------------------------------------+ %.jpg.o : %.jpg+ #---------------------------------------------------------------------------------+ @echo $(notdir $<)
− $(bin2o)
−
− -include $(DEPENDS)
−
− #---------------------------------------------------------------------------------
− endif
− #---------------------------------------------------------------------------------
1. Open the folder “libwiisprite/libwiisprite” then open the “include” folder. Next, copy the entire contents of the folder, there should be 8 files with the .h extension.+ +2. Next, open devkitPro/libogc/include ( \ slashes for windows) and paste the includes there.+ +3. Go back to libwiisprite and open the libwiisprite folder in libwiisprite. Then open lib and copy the one .a file there and paste it in devkitPro/libogc/lib/wii.+
−4. Again, go back to the root of libwiisprite and open libpng, copy the contents to the same place as the other .h files and then open.
−
−5. Open libwiisprite/libpng/lib and copy libpng.a and paste it in devkitPro/libogc/wii.
There’s another two functions that you may want to use, and they are GetWidth() and GetHeight. They get the width and height of the current screen. A possible application of this is to make sure your character doesn’t go beyond the edge of the screen, or where to draw your background or where to print your menu so that its centred.+
Line 425:
Line 426:
Line 590:
Line 596:
If you haven’t read the foreword, read it and don’t be lazy. This will be a fairly short lesson and at this point I will assume you have downloaded the Libwiisprite. First, you need to know how to set your make file. The basic template will look something like this:
If you haven’t read the foreword, read it and don’t be lazy. This will be a fairly short lesson and at this point I will assume you have downloaded the Libwiisprite. First, you need to know how to set your make file. The basic template will look something like this:
+<!-- Use source lang="text" to avoid munging Makefiles with spaces for Wiki -->
+<source lang="text">
+#---------------------------------------------------------------------------------
+# Clear the implicit built in rules
+#---------------------------------------------------------------------------------
+.SUFFIXES:
+#---------------------------------------------------------------------------------
+ifeq ($(strip $(DEVKITPPC)),)
+$(error "Please set DEVKITPPC in your environment. export DEVKITPPC=<path to>devkitPPC")
+endif
−include $(DEVKITPPC)/wii_rules
−#---------------------------------------------------------------------------------
−# TARGET is the name of the output
−# BUILD is the directory where object files & intermediate files will be placed
−# SOURCES is a list of directories containing source code
−# INCLUDES is a list of directories containing extra header files
−#---------------------------------------------------------------------------------
−TARGET := $(notdir $(CURDIR))
−BUILD := build
−SOURCES := source
−DATA := data
−INCLUDES :=
−#---------------------------------------------------------------------------------
−# options for code generation
−#---------------------------------------------------------------------------------
−CFLAGS = -g -O2 -mrvl -Wall $(MACHDEP) $(INCLUDE) -I$(DEVKITPPC)/local/include
−CXXFLAGS = $(CFLAGS)
−LDFLAGS = -g $(MACHDEP) -mrvl -Wl,-Map,$(notdir $@).map
−#---------------------------------------------------------------------------------
−# any extra libraries we wish to link with the project
−#---------------------------------------------------------------------------------
−LIBS := -lwiisprite -lpng -lz -lwiiuse -lbte -lfat -logc -lm
−#---------------------------------------------------------------------------------
−# list of directories containing libraries, this must be the top level containing
−# include and lib
−#---------------------------------------------------------------------------------
−LIBDIRS :=
−#---------------------------------------------------------------------------------
−# no real need to edit anything past this point unless you need to add additional
−# rules for different file extensions
−#---------------------------------------------------------------------------------
−ifneq ($(BUILD),$(notdir $(CURDIR)))
−#---------------------------------------------------------------------------------
−export OUTPUT := $(CURDIR)/$(TARGET)
−export VPATH := $(foreach dir,$(SOURCES),$(CURDIR)/$(dir)) \
− $(foreach dir,$(DATA),$(CURDIR)/$(dir))
−export DEPSDIR := $(CURDIR)/$(BUILD)
−#---------------------------------------------------------------------------------
−# automatically build a list of object files for our project
−#---------------------------------------------------------------------------------
−CFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.c)))
−CPPFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.cpp)))
−sFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.s)))
−SFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.S)))
−BINFILES := $(foreach dir,$(DATA),$(notdir $(wildcard $(dir)/*.*)))
−#---------------------------------------------------------------------------------
−# use CXX for linking C++ projects, CC for standard C
−#---------------------------------------------------------------------------------
−ifeq ($(strip $(CPPFILES)),)
− export LD := $(CC)
−else
− export LD := $(CXX)
−endif
−export OFILES := $(addsuffix .o,$(BINFILES)) \
− $(CPPFILES:.cpp=.o) $(CFILES:.c=.o) \
− $(sFILES:.s=.o) $(SFILES:.S=.o)
−#---------------------------------------------------------------------------------
−# build a list of include paths
−#---------------------------------------------------------------------------------
−export INCLUDE := $(foreach dir,$(INCLUDES), -iquote $(CURDIR)/$(dir)) \
− $(foreach dir,$(LIBDIRS),-I$(dir)/include) \
− -I$(CURDIR)/$(BUILD) \
− -I$(LIBOGC_INC)
−#---------------------------------------------------------------------------------
−# build a list of library paths
−#---------------------------------------------------------------------------------
−export LIBPATHS := $(foreach dir,$(LIBDIRS),-L$(dir)/lib) \
− -L$(LIBOGC_LIB) -L$(DEVKITPPC)/local/lib
−export OUTPUT := $(CURDIR)/$(TARGET)
−.PHONY: $(BUILD) clean
−#---------------------------------------------------------------------------------
−$(BUILD):
− @[ -d $@ ] || mkdir -p $@
− @make --no-print-directory -C $(BUILD) -f $(CURDIR)/Makefile
−#---------------------------------------------------------------------------------
−clean:
− @echo clean ...
− @rm -fr $(BUILD) $(OUTPUT).elf $(OUTPUT).dol
−#---------------------------------------------------------------------------------
−run:
− psoload $(TARGET).dol
−#---------------------------------------------------------------------------------
−reload:
− psoload -r $(TARGET).dol
−#---------------------------------------------------------------------------------
−else
−DEPENDS := $(OFILES:.o=.d)
−#---------------------------------------------------------------------------------
−# main targets
−#---------------------------------------------------------------------------------
−$(OUTPUT).dol: $(OUTPUT).elf
−$(OUTPUT).elf: $(OFILES)
−#---------------------------------------------------------------------------------
−# This rule links in binary data with the .jpg extension
−#---------------------------------------------------------------------------------
−%.jpg.o : %.jpg
−#---------------------------------------------------------------------------------
− @echo $(notdir $<)
− $(bin2o)
−-include $(DEPENDS)
−#---------------------------------------------------------------------------------
−endif
−#---------------------------------------------------------------------------------
−</source>
−(taken from the Libwiisprite template make file)
(taken from the Libwiisprite template make file)
Line 169:
Line 171:
In order to ‘install’ Libwiisprite, follow these steps
In order to ‘install’ Libwiisprite, follow these steps
−# Open the folder “libwiisprite/libwiisprite” then open the “include” folder. Next, copy the entire contents of the folder, there should be 8 files with the .h extension.
−# Next, open devkitPro/libogc/include ( \ slashes for windows) and paste the includes there.
−# Go back to libwiisprite and open the libwiisprite folder in libwiisprite. Then open lib and copy the one .a file there and paste it in devkitPro/libogc/lib/wii.
−# Again, go back to the root of libwiisprite and open libpng, copy the contents to the same place as the other .h files and then open.
−# Open libwiisprite/libpng/lib and copy libpng.a and paste it in devkitPro/libogc/wii.
−Now you are set up to start programming.
Now you are set up to start programming.
Line 257:
Line 255:
There are a few other functions in the GameVideo class that may be of use. The first I will mention is StopVideo(), the documentation defines it like this:
There are a few other functions in the GameVideo class that may be of use. The first I will mention is StopVideo(), the documentation defines it like this:
− void StopVideo () Shuts the video subsystem down. It won't work if Video wasn't initialized before.
+ void StopVideo () Shuts the video subsystem down. It won't work if Video
+ wasn't initialized before.
Again, not much info, but it doesn’t require much information to understand, this shuts down the Video systems on the Wii, it’s kind of the opposite of InitWii(), this leads me on to my second function, IsInitialized() defined in the documentation as such:
Again, not much info, but it doesn’t require much information to understand, this shuts down the Video systems on the Wii, it’s kind of the opposite of InitWii(), this leads me on to my second function, IsInitialized() defined in the documentation as such:
Line 274:
Line 273:
</source>
</source>
−There’s another two functions that you may want to use, and they are GetWidth() and GetHeight. They get the width and height of the current screen. A possible application of this is to make sure your character doesn’t go beyond the edge of the screen, or where to draw your background or where to print your menu so that its centred.
That’s it for this lesson, I would advise you play around with the numbers in the SetBackground() function if you still don’t see how they work, playing with numbers can teach you an awful lot. Also, try and replace the wiisprite.h with the only header(s) that are required for this program.
That’s it for this lesson, I would advise you play around with the numbers in the SetBackground() function if you still don’t see how they work, playing with numbers can teach you an awful lot. Also, try and replace the wiisprite.h with the only header(s) that are required for this program.
Line 359:
Line 358:
Parameters:
Parameters:
image The image for this sprite.
image The image for this sprite.
− frameWidth The width of the frame. Should be a multiple of image->GetWidth() or 0 if it should get the same width as the image.
+ frameWidth The width of the frame. Should be a multiple of image->GetWidth()
− frameHeight The height of the frame. Should be a multiple of image->GetHeight() or 0 if it should get the same height as the image.
+ or 0 if it should get the same width as the image.
+ frameHeight The height of the frame. Should be a multiple of image->GetHeight()
+ or 0 if it should get the same height as the image.
Sets the zooming of the sprite. It resets any defined stretch values.
Sets the zooming of the sprite. It resets any defined stretch values.
Parameters:
Parameters:
− zoom The new zoom of the sprite. 1 is normal size, cannot be smaller than 0.
+ zoom The new zoom of the sprite. 1 is normal size, cannot be smaller
+ than 0.
CURRENT ZOOM CANNOT BE SMALLER THAN 0! Make sure you go by this rule, to make sure that your images zoom level never goes below 0 you may add a simple check like this:
CURRENT ZOOM CANNOT BE SMALLER THAN 0! Make sure you go by this rule, to make sure that your images zoom level never goes below 0 you may add a simple check like this:
Line 437:
Line 439:
f32 wsp::Sprite::GetZoom ( ) const
f32 wsp::Sprite::GetZoom ( ) const
− Gets the zooming of the sprite. If StretchWidth is not the same as StretchHeight, it returns 0.
+ Gets the zooming of the sprite. If StretchWidth is not the same as
+ StretchHeight, it returns 0.
Returns: The current zoom of the sprite. 1 is normal size.
Returns: The current zoom of the sprite. 1 is normal size.
Line 476:
Line 479:
Sets the transparency of the sprite.
Sets the transparency of the sprite.
− Parameters: alpha Sets the transparency. Has a range from 0x00 (invisible) to 0xFF (fully visible)
+ Parameters: alpha Sets the transparency. Has a range from 0x00 (invisible)
+ to 0xFF (fully visible)
The values 0x00 and 0xFF are hexadecimal or more commonly called ‘hex’, this is how most of your image will be handled although the functions are just as happy to work with decimal as shown in the code segment at the start of the Transparency section. In our example, 0x00 is the same as 0 (no alpha, and 0xFF is 255 (fully opaque). Now let’s look again at that code segment
The values 0x00 and 0xFF are hexadecimal or more commonly called ‘hex’, this is how most of your image will be handled although the functions are just as happy to work with decimal as shown in the code segment at the start of the Transparency section. In our example, 0x00 is the same as 0 (no alpha, and 0xFF is 255 (fully opaque). Now let’s look again at that code segment
Line 497:
Line 501:
Returns:
Returns:
− The current transparency of the sprite. Has a range from 0x00 (invisible) to 0xFF (fully visible)
+ The current transparency of the sprite. Has a range from 0x00 (invisible) to
+ 0xFF (fully visible)
So now we know what GetTransparency() does (if you didn’t know before), then it will compare that value to 0xFF – 4 (think of it as being 255 – 4 = 251). To put this into an equation, we will assume that the native alpha value of the image is 255, or 0xFF:
So now we know what GetTransparency() does (if you didn’t know before), then it will compare that value to 0xFF – 4 (think of it as being 255 – 4 = 251). To put this into an equation, we will assume that the native alpha value of the image is 255, or 0xFF:
Line 524:
Line 529:
Sets the height stretch of the sprite.
Sets the height stretch of the sprite.
Parameters:
Parameters:
− stretchHeight Stretches the height of the sprite by this value. 1 is normal size, cannot be smaller than 0.
+ stretchHeight Stretches the height of the sprite by this value. 1 is
+ normal size, cannot be smaller than 0.
Sets the rotation angle of the sprite.
Sets the rotation angle of the sprite.
Parameters:
Parameters:
− rotation The new angle of the sprite. It is measured in degrees/2, so if 90 degrees is wanted, 45 degrees should be the passed parameter.
+ rotation The new angle of the sprite. It is measured in degrees/2,
+ so if 90 degrees is wanted, 45 degrees should be the passed
+ parameter.
In the program the following line of code is called.
In the program the following line of code is called.