Package net.minecraftforge.fml.loading
Record Class ImmediateWindowHandler.DummyProvider
java.lang.Object
java.lang.Record
net.minecraftforge.fml.loading.ImmediateWindowHandler.DummyProvider
- All Implemented Interfaces:
ImmediateWindowProvider
- Enclosing class:
ImmediateWindowHandler
private static record ImmediateWindowHandler.DummyProvider()
extends Record
implements ImmediateWindowProvider
-
Field Summary
-
Constructor Summary
ModifierConstructorDescriptionprivate
Creates an instance of aDummyProvider
record class. -
Method Summary
Modifier and TypeMethodDescriptionfinal boolean
Indicates whether some other object is "equal to" this one.This is called to construct aForgeFeature
for the GL_VERSION we managed to create for the window.final int
hashCode()
Returns a hash code value for this object.initialize
(String[] args) This is called very early on to initialize ourselves.<T> Supplier
<T> Return a Supplier of an object extending the LoadingOverlay class from Mojang.name()
void
This is called periodically during the loading process to "tick" the window.boolean
positionWindow
(Optional<Object> monitor, IntConsumer widthSetter, IntConsumer heightSetter, IntConsumer xSetter, IntConsumer ySetter) This is called after window handoff to allow us to tell Mojang about our window's position.long
setupMinecraftWindow
(IntSupplier width, IntSupplier height, Supplier<String> title, LongSupplier monitor) This is called to setup the minecraft window, as if Mojang had done it themselves in their Window class.final String
toString()
Returns a string representation of this record class.void
updateFramebufferSize
(IntConsumer width, IntConsumer height) This will be called during the handoff to minecraft to update minecraft with the size of the framebuffer we have.void
updateModuleReads
(ModuleLayer layer) This is called during the module loading process to allow us to find objects inside the GAME layer, such as a later loading screen.
-
Field Details
-
NV_HANDOFF
-
NV_POSITION
-
NV_OVERLAY
-
NV_VERSION
-
-
Constructor Details
-
DummyProvider
private DummyProvider()Creates an instance of aDummyProvider
record class.
-
-
Method Details
-
name
- Specified by:
name
in interfaceImmediateWindowProvider
- Returns:
- The name of this window provider. Do NOT use fmlearlywindow.
-
initialize
Description copied from interface:ImmediateWindowProvider
This is called very early on to initialize ourselves. Use this to initialize the window and other GL core resources. One thing we want to ensure is that we try and create the highest GL_PROFILE we can accomplish. GLFW_CONTEXT_VERSION_MAJOR,GLFW_CONTEXT_VERSION_MINOR should be as high as possible on the created window, and it should have all the typical profile settings.- Specified by:
initialize
in interfaceImmediateWindowProvider
- Parameters:
args
- The arguments provided to the Java process. This is the entire command line, so you can process stuff from it.- Returns:
- A runnable that will be periodically ticked by FML during startup ON THE MAIN THREAD. This is usually a good place to put glfwPollEvents() tests.
-
updateFramebufferSize
Description copied from interface:ImmediateWindowProvider
This will be called during the handoff to minecraft to update minecraft with the size of the framebuffer we have. Generally won't be called because Minecraft figures it out for itself.- Specified by:
updateFramebufferSize
in interfaceImmediateWindowProvider
- Parameters:
width
- Consumer of the framebuffer widthheight
- Consumer of the framebuffer height
-
setupMinecraftWindow
public long setupMinecraftWindow(IntSupplier width, IntSupplier height, Supplier<String> title, LongSupplier monitor) Description copied from interface:ImmediateWindowProvider
This is called to setup the minecraft window, as if Mojang had done it themselves in their Window class. This handoff is difficult to get right - you have to make sure that any activities you're doing to the window are finished prior to returning. You should try and setup the width and height as Mojang expects - the suppliers give you all that information. Alternatively, you can force Mojang to update from the current position of the window inImmediateWindowProvider.positionWindow(Optional, IntConsumer, IntConsumer, IntConsumer, IntConsumer)
instead. This might give a more seamless experience.- Specified by:
setupMinecraftWindow
in interfaceImmediateWindowProvider
- Parameters:
width
- This is the width of the window Mojang expectsheight
- This is the height of the Window Mojang expects.title
- This is the title for the window.monitor
- This is the monitor it should appear on.- Returns:
- The window id
-
positionWindow
public boolean positionWindow(Optional<Object> monitor, IntConsumer widthSetter, IntConsumer heightSetter, IntConsumer xSetter, IntConsumer ySetter) Description copied from interface:ImmediateWindowProvider
This is called after window handoff to allow us to tell Mojang about our window's position. This might give a preferrable user experience to users, because we just tell Mojang our truth, rather than accept theirs.- Specified by:
positionWindow
in interfaceImmediateWindowProvider
- Parameters:
monitor
- This is the monitor we're rendering on. Note that this is the Mojang monitor object. You might have trouble unwrapping it.widthSetter
- This sets the width on the Mojang sideheightSetter
- This sets the height on the Mojang sidexSetter
- This sets the x coordinate on the Mojang sideySetter
- This sets the y coordinate on the Mojang side- Returns:
- true if you've handled the window positioning - this skips the "forced fullscreen" code until a later stage
-
loadingOverlay
public <T> Supplier<T> loadingOverlay(Supplier<?> mc, Supplier<?> ri, Consumer<Optional<Throwable>> ex, boolean fade) Description copied from interface:ImmediateWindowProvider
Return a Supplier of an object extending the LoadingOverlay class from Mojang. This is what will be used once the Mojang window code has taken over rendering of the window, to render the later stages of the loading process.- Specified by:
loadingOverlay
in interfaceImmediateWindowProvider
- Type Parameters:
T
- This is the type LoadingOverlay to allow type binding on the Mojang side- Parameters:
mc
- This supplies the Minecraft objectri
- This supplies the ReloadInstance object that tells us when the loading is finishedex
- This Consumes the final state of the loading - if it's an error you pass it the Throwable, otherwise you pass Optional.empty()fade
- This is the fade flag passed to LoadingOverlay. You probably want to ignore it.- Returns:
- A supplier of your later LoadingOverlay screen.
-
getGLVersion
Description copied from interface:ImmediateWindowProvider
This is called to construct aForgeFeature
for the GL_VERSION we managed to create for the window. Should be a string of the format {MAJOR}.{MINOR}, such as 4.6, 4.5 or such.- Specified by:
getGLVersion
in interfaceImmediateWindowProvider
- Returns:
- the GL profile we created
-
updateModuleReads
Description copied from interface:ImmediateWindowProvider
This is called during the module loading process to allow us to find objects inside the GAME layer, such as a later loading screen.- Specified by:
updateModuleReads
in interfaceImmediateWindowProvider
- Parameters:
layer
- This is the GAME layer from ModLauncher
-
periodicTick
public void periodicTick()Description copied from interface:ImmediateWindowProvider
This is called periodically during the loading process to "tick" the window. It is typically the same as the Runnable fromImmediateWindowProvider.initialize(String[])
- Specified by:
periodicTick
in interfaceImmediateWindowProvider
-
toString
Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components. -
hashCode
public final int hashCode()Returns a hash code value for this object. The value is derived from the hash code of each of the record components. -
equals
Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal.
-