mirror of
https://github.com/wiiu-env/WiiUPluginSystem.git
synced 2024-11-16 07:39:24 +01:00
Add a example plugin that compatible with the new loader.
This commit is contained in:
Maschell
parent
55e7a67a48
commit
e42230b9a2
300
plugins/example_plugin/Makefile
Normal file
300
plugins/example_plugin/Makefile
Normal file
@ -0,0 +1,300 @@
|
|||||||
|
# You probably never need to adjust this Makefile.
|
||||||
|
# All changes can be done in the makefile.mk
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# Clear the implicit built in rules
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
.SUFFIXES:
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
ifeq ($(strip $(DEVKITPPC)),)
|
||||||
|
$(error "Please set DEVKITPPC in your environment. export DEVKITPPC=<path to>devkitPPC")
|
||||||
|
endif
|
||||||
|
ifeq ($(strip $(DEVKITPRO)),)
|
||||||
|
$(error "Please set DEVKITPRO in your environment. export DEVKITPRO=<path to>devkitPRO")
|
||||||
|
endif
|
||||||
|
|
||||||
|
export PATH := $(DEVKITPPC)/bin:$(PORTLIBS)/bin:$(PATH)
|
||||||
|
export PORTLIBS := $(DEVKITPRO)/portlibs/ppc
|
||||||
|
export WUPSDIR := $(DEVKITPRO)/wups
|
||||||
|
export GCC_VER := $(shell $(DEVKITPPC)/bin/powerpc-eabi-gcc -dumpversion)
|
||||||
|
|
||||||
|
PREFIX := powerpc-eabi-
|
||||||
|
|
||||||
|
export AS := $(PREFIX)as
|
||||||
|
export CC := $(PREFIX)gcc
|
||||||
|
export CXX := $(PREFIX)g++
|
||||||
|
export LD := $(PREFIX)ld
|
||||||
|
export AR := $(PREFIX)ar
|
||||||
|
export OBJCOPY := $(PREFIX)objcopy
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# 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
|
||||||
|
|
||||||
|
ifeq ($(notdir $(CURDIR)),$(BUILD))
|
||||||
|
include ../makefile.mk
|
||||||
|
else
|
||||||
|
include makefile.mk
|
||||||
|
endif
|
||||||
|
|
||||||
|
include $(WUPSDIR)/plugin_makefile.mk
|
||||||
|
|
||||||
|
|
||||||
|
#MAP ?= $(TARGET:.mod=.map)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# options for code generation
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# -Os: optimise size
|
||||||
|
# -Wall: generate lots of warnings
|
||||||
|
# -D__wiiu__: define the symbol __wiiu__ (used in some headers)
|
||||||
|
# -mcpu=750: enable processor specific compilation
|
||||||
|
# -meabi: enable eabi specific compilation
|
||||||
|
# -mhard-float: enable hardware floating point instructions
|
||||||
|
# -nostartfiles: Do not use the standard system startup files when linking
|
||||||
|
# -ffunction-sections: split up functions so linker can garbage collect
|
||||||
|
# -fdata-sections: split up data so linker can garbage collect
|
||||||
|
COMMON_CFLAGS := -Os -Wall -mcpu=750 -meabi -mhard-float -D__WIIU__ -nostartfiles -ffunction-sections -fdata-sections -Wl,-q $(COMMON_CFLAGS)
|
||||||
|
|
||||||
|
# -x c: compile as c code
|
||||||
|
# -std=c11: use the c11 standard
|
||||||
|
CFLAGS := $(COMMON_CFLAGS) -x c -std=gnu11 $(CFLAGS)
|
||||||
|
|
||||||
|
# -x c: compile as c++ code
|
||||||
|
# -std=gnu++11: use the c++11 standard
|
||||||
|
CXXFLAGS := $(COMMON_CFLAGS) -x c++ -std=gnu++11 $(CXXFLAGS)
|
||||||
|
|
||||||
|
ifeq ($(DO_LOGGING), 1)
|
||||||
|
CFLAGS += -D__LOGGING__
|
||||||
|
CXXFLAGS += -D__LOGGING__
|
||||||
|
endif
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# any extra ld flags
|
||||||
|
#--------------------------------------------------------------------------------
|
||||||
|
# --gc-sections: remove unneeded symbols
|
||||||
|
# -Map: generate a map file
|
||||||
|
LDFLAGS += -Wl,-Map,$(notdir $@).map,--gc-sections
|
||||||
|
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
Q := @
|
||||||
|
MAKEFLAGS += --no-print-directory
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# any extra libraries we wish to link with the project
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
LIBS +=
|
||||||
|
#
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# list of directories containing libraries, this must be the top level containing
|
||||||
|
# include and lib
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
LIBDIRS +=
|
||||||
|
|
||||||
|
NEEDS_WUT := 0
|
||||||
|
|
||||||
|
ifeq ($(WUT_ENABLE_CPP), 1)
|
||||||
|
WUT_ENABLE_NEWLIB := 1
|
||||||
|
|
||||||
|
LDFLAGS += -Wl,-whole-archive,-lwutstdc++,-no-whole-archive
|
||||||
|
NEEDS_WUT := 1
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifeq ($(WUT_ENABLE_NEWLIB), 1)
|
||||||
|
LDFLAGS += -Wl,-whole-archive,-lwutnewlib,-no-whole-archive
|
||||||
|
NEEDS_WUT := 1
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifeq ($(WUT_DEFAULT_MALLOC), 1)
|
||||||
|
LDFLAGS += -Wl,-whole-archive,-lwutmalloc,-no-whole-archive
|
||||||
|
NEEDS_WUT := 1
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifeq ($(NEEDS_WUT), 1)
|
||||||
|
ifeq ($(strip $(WUT_ROOT)),)
|
||||||
|
$(error "Please set WUT_ROOT in your environment. export WUT_ROOT=<path to>wut)
|
||||||
|
endif
|
||||||
|
CFLAGS += -D__WUT__
|
||||||
|
CXXFLAGS += -D__WUT__
|
||||||
|
endif
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# 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 PROJECTDIR := $(CURDIR)
|
||||||
|
export OUTPUT := $(CURDIR)/$(TARGETDIR)/$(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)/*.*)))
|
||||||
|
TTFFILES := $(foreach dir,$(DATA),$(notdir $(wildcard $(dir)/*.ttf)))
|
||||||
|
PNGFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.png)))
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# use CXX for linking C++ projects, CC for standard C
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
ifeq ($(strip $(CPPFILES)),)
|
||||||
|
export REAL_LD := $(CC)
|
||||||
|
else
|
||||||
|
export REAL_LD := $(CXX)
|
||||||
|
endif
|
||||||
|
|
||||||
|
export OFILES := $(CPPFILES:.cpp=.o) $(CFILES:.c=.o) \
|
||||||
|
$(sFILES:.s=.o) $(SFILES:.S=.o) \
|
||||||
|
$(PNGFILES:.png=.png.o) $(addsuffix .o,$(BINFILES))
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# build a list of include paths
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
export INCLUDE_FULL += $(foreach dir,$(INCLUDES),-I$(CURDIR)/$(dir)) \
|
||||||
|
$(foreach dir,$(LIBDIRS),-I$(dir)/include) \
|
||||||
|
$(EXTERNAL_INCLUDE)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# build a list of library paths
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
export LIBPATHS_FULL += $(foreach dir,$(LIBDIRS),-L$(dir)/lib) \
|
||||||
|
$(EXTERNAL_LIBPATHS)
|
||||||
|
|
||||||
|
|
||||||
|
export OUTPUT := $(CURDIR)/$(TARGET)
|
||||||
|
.PHONY: $(BUILD) clean install
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
$(BUILD):
|
||||||
|
@[ -d $@ ] || mkdir -p $@
|
||||||
|
@$(MAKE) --no-print-directory -C $(BUILD) -f $(CURDIR)/Makefile
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
clean:
|
||||||
|
@echo clean ...
|
||||||
|
@rm -fr $(BUILD) $(OUTPUT).mod $(OUTPUT)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
else
|
||||||
|
|
||||||
|
DEPENDS := $(OFILES:.o=.d)
|
||||||
|
|
||||||
|
THIS_DIR := $(dir $(abspath $(lastword $(MAKEFILE_LIST))))
|
||||||
|
|
||||||
|
###############################################################################
|
||||||
|
# Rule to make everything.
|
||||||
|
PHONY += all
|
||||||
|
|
||||||
|
all : $(OUTPUT)
|
||||||
|
###############################################################################
|
||||||
|
# Special build rules
|
||||||
|
|
||||||
|
|
||||||
|
# Rule to make the module file.
|
||||||
|
$(OUTPUT) : $(OFILES)
|
||||||
|
@echo "linking ... " $@
|
||||||
|
@$(REAL_LD) $(OFILES) $(LDFLAGS) $(LIBS) $(LIBPATHS_FULL) -o $@
|
||||||
|
|
||||||
|
###############################################################################
|
||||||
|
# Standard build rules
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.a:
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
@echo $(notdir $@)
|
||||||
|
@rm -f $@
|
||||||
|
@$(AR) -rc $@ $^
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.o: %.cpp
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@$(CXX) -MMD -MP -MF $(DEPSDIR)/$*.d $(CXXFLAGS) $(INCLUDE_FULL) -c $< -o $@ $(ERROR_FILTER)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.o: %.c
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@$(CC) -MMD -MP -MF $(DEPSDIR)/$*.d $(CFLAGS) $(INCLUDE_FULL) -c $< -o $@ $(ERROR_FILTER)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.o: %.S
|
||||||
|
@echo $(notdir $<)
|
||||||
|
$(CC) -MMD -MP -MF $(DEPSDIR)/$*.d -x assembler-with-cpp $(INCLUDE_FULL) -c $< -o $@ $(ERROR_FILTER)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.png.o : %.png
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.jpg.o : %.jpg
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.ttf.o : %.ttf
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.bin.o : %.bin
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.wav.o : %.wav
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.mp3.o : %.mp3
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
%.ogg.o : %.ogg
|
||||||
|
@echo $(notdir $<)
|
||||||
|
@bin2s -a 32 $< | $(AS) -o $(@)
|
||||||
|
|
||||||
|
###############################################################################
|
||||||
|
# Assembly listing rules
|
||||||
|
|
||||||
|
# Rule to make assembly listing.
|
||||||
|
PHONY += list
|
||||||
|
list : $(LIST)
|
||||||
|
|
||||||
|
# Rule to make the listing file.
|
||||||
|
%.list : $(TARGET)
|
||||||
|
$(LOG)
|
||||||
|
-$Qmkdir -p $(dir $@)
|
||||||
|
$Q$(OBJDUMP) -d $< > $@
|
||||||
|
|
||||||
|
###############################################################################
|
||||||
|
# Clean rule
|
||||||
|
|
||||||
|
# Rule to clean files.
|
||||||
|
PHONY += clean
|
||||||
|
clean :
|
||||||
|
$Qrm -rf $(wildcard $(BUILD) $(BIN))
|
||||||
|
|
||||||
|
###############################################################################
|
||||||
|
# Phony targets
|
||||||
|
|
||||||
|
.PHONY : $(PHONY)
|
||||||
|
|
||||||
|
-include $(DEPENDS)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
endif
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
12
plugins/example_plugin/README.md
Normal file
12
plugins/example_plugin/README.md
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
# Example plugin
|
||||||
|
|
||||||
|
This is just a simple example plugin which can be used as a template.
|
||||||
|
|
||||||
|
## Building
|
||||||
|
|
||||||
|
For building you need:
|
||||||
|
- [wups](https://github.com/Maschell/WiiUPluginSystem)
|
||||||
|
- [wut](https://github.com/decaf-emu/wut)
|
||||||
|
- [libutils](https://github.com/Maschell/libutils/tree/wut) for common functions (WUT version).
|
||||||
|
|
||||||
|
Install them (in this order) according to their README's. Don't forget the dependencies of the libs itself.
|
||||||
64
plugins/example_plugin/makefile.mk
Normal file
64
plugins/example_plugin/makefile.mk
Normal file
@ -0,0 +1,64 @@
|
|||||||
|
# Compiling the projects with libutils logging code?
|
||||||
|
DO_LOGGING := 1
|
||||||
|
|
||||||
|
# Links against the wut implementation of newlib, this is useful for using any function
|
||||||
|
# from the C standard library
|
||||||
|
WUT_ENABLE_NEWLIB := 0
|
||||||
|
|
||||||
|
# Links against the wut implementation of stdcpp, this is useful for using any function
|
||||||
|
# from the C++ standard library. This will enable WUT_ENABLE_NEWLIB if you have not already done so.
|
||||||
|
WUT_ENABLE_CPP := 0
|
||||||
|
|
||||||
|
# By default newlib will allocate 90% of the default heap for use with sbrk & malloc,
|
||||||
|
# if this is unacceptable to you then you should use this as it replaces the newlib
|
||||||
|
# malloc functions which ones which redirect to the CafeOS default heap functions
|
||||||
|
# such as MEMAllocFromDefaultHeap.
|
||||||
|
WUT_DEFAULT_MALLOC := 0
|
||||||
|
|
||||||
|
# Target filename
|
||||||
|
TARGET := $(notdir $(CURDIR)).mod
|
||||||
|
|
||||||
|
# Source directories
|
||||||
|
SOURCES := src
|
||||||
|
|
||||||
|
# Data directories
|
||||||
|
DATA :=
|
||||||
|
|
||||||
|
# Include directories
|
||||||
|
INCLUDES := src
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# options for code generation and linking
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# Extra C AND C++ compiler flags
|
||||||
|
COMMON_CFLAGS :=
|
||||||
|
# Extra C compiler flags
|
||||||
|
CFLAGS :=
|
||||||
|
# Extra C++ compiler flags
|
||||||
|
CXXFLAGS :=
|
||||||
|
# Extra linking flags for all linking steps
|
||||||
|
LDFLAGS :=
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# list of directories containing libraries, this must be the top level containing
|
||||||
|
# include and lib
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
LIBDIRS := $(WUPSDIR) $(WUT_ROOT)
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# any extra libraries we wish to link with the project
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
LIBS := -lwups -lutilswut -lcoreinit -lnsysnet
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# Will be added to the final lib paths
|
||||||
|
# example:
|
||||||
|
# -L$C:/library1/lib
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
EXTERNAL_LIBPATHS :=
|
||||||
|
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
# Will be added to the final include paths
|
||||||
|
# -IC:/library1/include
|
||||||
|
#---------------------------------------------------------------------------------
|
||||||
|
EXTERNAL_INCLUDE := -I$(WUT_ROOT)/include/libutilswut
|
||||||
139
plugins/example_plugin/src/main.cpp
Normal file
139
plugins/example_plugin/src/main.cpp
Normal file
@ -0,0 +1,139 @@
|
|||||||
|
#include <wups.h>
|
||||||
|
#include <malloc.h>
|
||||||
|
#include <string.h>
|
||||||
|
#include <nsysnet/socket.h>
|
||||||
|
#include <utils/logger.h>
|
||||||
|
#include <coreinit/filesystem.h>
|
||||||
|
|
||||||
|
/**
|
||||||
|
Mandatory plugin information.
|
||||||
|
If not set correctly, the loader will refuse to use the plugin.
|
||||||
|
**/
|
||||||
|
WUPS_PLUGIN_NAME("Example plugin");
|
||||||
|
WUPS_PLUGIN_DESCRIPTION("This is just an example plugin and will log the FSOpenFile function.");
|
||||||
|
WUPS_PLUGIN_VERSION("v1.0");
|
||||||
|
WUPS_PLUGIN_AUTHOR("Maschell");
|
||||||
|
WUPS_PLUGIN_LICENSE("BSD");
|
||||||
|
|
||||||
|
/**
|
||||||
|
Add this to one of your projects file to have access to SD/USB.
|
||||||
|
**/
|
||||||
|
WUPS_FS_ACCESS()
|
||||||
|
/**
|
||||||
|
Add this to one of your projects file to be able to create overlays.
|
||||||
|
**/
|
||||||
|
WUPS_ALLOW_OVERLAY()
|
||||||
|
|
||||||
|
/**
|
||||||
|
All of this defines can be used in ANY file.
|
||||||
|
It's possible to split it up into multiple files.
|
||||||
|
|
||||||
|
**/
|
||||||
|
|
||||||
|
/**
|
||||||
|
Get's called ONCE when the loader exits, but BEFORE the ON_APPLICATION_START gets called or functions are overridden.
|
||||||
|
**/
|
||||||
|
INITIALIZE_PLUGIN(){
|
||||||
|
socket_lib_init();
|
||||||
|
log_init();
|
||||||
|
DEBUG_FUNCTION_LINE("INITIALIZE_PLUGIN of example_plugin!\n");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Gets called when the plugin loader is re-entered => when the plugin is unloaded.
|
||||||
|
The overridden functions are restored before this is getting called.
|
||||||
|
**/
|
||||||
|
DEINITIALIZE_PLUGIN(){
|
||||||
|
socket_lib_init();
|
||||||
|
log_init();
|
||||||
|
DEBUG_FUNCTION_LINE("DEINITIALIZE_PLUGIN of example_plugin!\n");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Gets called when an application starts.
|
||||||
|
This is called BEFORE the functions are overridden.
|
||||||
|
Make sure to initialize all functions you're using in the overridden functions!
|
||||||
|
**/
|
||||||
|
ON_APPLICATION_START(){
|
||||||
|
socket_lib_init();
|
||||||
|
log_init();
|
||||||
|
|
||||||
|
DEBUG_FUNCTION_LINE("ON_APPLICATION_START of example_plugin!\n");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Gets called when an application ends. A good place for freeing memory.
|
||||||
|
**/
|
||||||
|
ON_APPLICATION_ENDING(){
|
||||||
|
DEBUG_FUNCTION_LINE("ON_APPLICATION_ENDING of example_plugin!\n");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Gets called on each frame.
|
||||||
|
**/
|
||||||
|
ON_VYSNC(){
|
||||||
|
DEBUG_FUNCTION_LINE("ON_VYSNC of example_plugin!\n");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
Gets called whenever the application status changes.
|
||||||
|
|
||||||
|
Possible values of "status":
|
||||||
|
WUPS_APP_STATUS_FOREGROUND, App is now running in foreground
|
||||||
|
WUPS_APP_STATUS_BACKGROUND App is now running in background
|
||||||
|
WUPS_APP_STATUS_CLOSED App is going to be closed
|
||||||
|
**/
|
||||||
|
ON_APP_STATUS_CHANGED(status){
|
||||||
|
if(status == WUPS_APP_STATUS_FOREGROUND){
|
||||||
|
DEBUG_FUNCTION_LINE("ON_APP_STATUS_CHANGED of example_plugin! App is now in foreground\n");
|
||||||
|
} else if(status == WUPS_APP_STATUS_BACKGROUND){
|
||||||
|
DEBUG_FUNCTION_LINE("ON_APP_STATUS_CHANGED of example_plugin! App is now in background\n");
|
||||||
|
} else if(status == WUPS_APP_STATUS_CLOSED){
|
||||||
|
DEBUG_FUNCTION_LINE("ON_APP_STATUS_CHANGED of example_plugin! App is now going to be closed\n");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
This defines a function replacement.
|
||||||
|
It allows to replace the system function with an own function.
|
||||||
|
So whenever a game / application calles an overridden function, your function gets called instead.
|
||||||
|
|
||||||
|
Currently it's only possible to override functions that are loaded from .rpl files of OSv10 (00050010-1000400A).
|
||||||
|
|
||||||
|
Signature of this macro:
|
||||||
|
DECL_FUNCTION( RETURN_TYPE, ARBITRARY_NAME_OF_FUNCTION , ARGS_SEPERATED_BY_COMMA){
|
||||||
|
//Your code goes here.
|
||||||
|
}
|
||||||
|
|
||||||
|
Within this macro, two more function get declare you can use.
|
||||||
|
my_ARBITRARY_NAME_OF_FUNCTION and real_FSOpenFile
|
||||||
|
|
||||||
|
RETURN_TYPE my_ARBITRARY_NAME_OF_FUNCTION(ARGS_SEPERATED_BY_COMMA):
|
||||||
|
is just name of the function that gets declared in this macro.
|
||||||
|
It has the same effect as calling the overridden function directly.
|
||||||
|
|
||||||
|
RETURN_TYPE real_ARBITRARY_NAME_OF_FUNCTION(ARGS_SEPERATED_BY_COMMA):
|
||||||
|
is the name of the function, that leads to function that was overridden.
|
||||||
|
Use this to call the original function that will be overridden.
|
||||||
|
CAUTION: Other plugins may already have manipulated the the return value or arguments.
|
||||||
|
|
||||||
|
|
||||||
|
Use this macro for each function you want to override
|
||||||
|
|
||||||
|
**/
|
||||||
|
DECL_FUNCTION(int, FSOpenFile, FSClient *pClient, FSCmdBlock *pCmd, const char *path, const char *mode, int *handle, int error) {
|
||||||
|
int result = real_FSOpenFile(pClient, pCmd, path, mode, handle, error);
|
||||||
|
|
||||||
|
DEBUG_FUNCTION_LINE("FSOpenFile called for folder %s! Result %d\n",path,result);
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
This tells the loader which functions from which library (.rpl) should be replaced with which function from this file.
|
||||||
|
The list of possible libraries can be found in the wiki. (In general it's WUPS_LOADER_LIBRARY_ + the name of the RPL in caps lock)
|
||||||
|
|
||||||
|
WUPS_MUST_REPLACE(FUNCTION_NAME_IN_THIS_FILE, NAME_OF_LIB_WHICH_CONTAINS_THIS_FUNCTION, NAME_OF_FUNCTION_TO_OVERRIDE)
|
||||||
|
|
||||||
|
Define this for each function you want to override.
|
||||||
|
**/
|
||||||
|
WUPS_MUST_REPLACE(FSOpenFile, WUPS_LOADER_LIBRARY_COREINIT, FSOpenFile);
|
||||||
Loading…
Reference in New Issue
Block a user