Jump to content

Blogs

Couple new GUI script functions for 1.06

1.06 will have a number of new script functions that will give improved control over custom GUIs.   Two of the new script functions are:   SetGUIProgressBarPosition();   This script function will let you set the position of a progress bar (Between 0.0 for empty and 1.0 for full).   The other new function is:   SetGUITexture();   This script function will let you set the texture for a UIIcon, a UIFrame's fill texture, or a Button's Base Frame's fill texture.   Both script fun

Rob McGinnis

Rob McGinnis

Video Games: Mature Themes

Even video games with good writing are usually banal and puerile in their content. The exploration of themes in games is typically shallow and any didactic purpose the writers attempt to achieve is usually aimed very low. When an eleven year-old already inherently comprehends and accepts the lesson you are trying to impart, you know you're not dropping the bucket too deep into the well. A converse problem is that the themes being explored are so far outside of a player's daily concerns that they

J.E. Sawyer

J.E. Sawyer

Multiple Callbacks Per Event

By Rich Taylor   In 1.06, it will be possible to set up multiple GUI callbacks on a single UI event in XML. The syntax will be to use the event name and append a number to it. The engine will read in the callbacks until it fails to find the next sequential number.   For example, I could set up a UI Button to with the following callbacks:   OnUpdate=UIObject_OnUpdate_DisableIfLocalVarEquals(local:3,"true") OnLeftClick=UIObject_Input_ScreenOpen("SCREEN_OPTIONS","false") OnLeftClick0=U

Rob McGinnis

Rob McGinnis

UIObject_Tooltip_DisplayTooltipString

UIObject_Tooltip_DisplayTooltipString takes up to 9 parameters, but only the first four parameters are required.   Parameter list:   Message = The literal string to display in the tooltip   XLoc = The X origin for where the tooltip should appear. This can be a pixel location, or you can use the following two strings to make it relative: MOUSE_X will place the X origin of the tooltip near where the mouse is. OBJECT_X will place the tooltip next to the UIObject that is being moused over,

Rob McGinnis

Rob McGinnis

UIObject_Misc_StoreObjectData

The only valid parameter to this callback is a local or global GUI variable index. localguivars are expressed as local:#, where # is the index for the variable.   globalguivars are expressed as global:#, where # is the index for the variable.   This callback takes the engine-level data in a UIObject and stores it in a global or local gui variable. The engine-level data will vary from UIObject to UIObject. It is also impossible to specify which data item you want to set the GUI variable t

Rob McGinnis

Rob McGinnis

UIButton_OnUpdate_ControlSelected

This callback takes a single parameter. It's only purpose is to enable or disable a button based on whether or not the user has selected a row in a List Box.   The single parameter is: sListBoxName = The name of the list box we want to check for selection.   If the user has a row selected in the listbox named in the parameter, then the UIButton will be set to Enabled.   If the user does not have a row selected in the listbox named in the parameter, then the UIButton will be disabled.

Rob McGinnis

Rob McGinnis

Writing in Computer Games.

Someone wrote me a letter this weekend, asking if I had any suggestions for breaking into computer game writing, and it occured to me I didn't. I had suggestions for breaking into computer game design, but...   Anyway, here's the gist of the response in case anyone else has a similar question about how it all works.   Writing for video games is something of a different beast compared to game design. My experience is that someone will contract a writer (and usually late in the process) onc

Chris Avellone

Chris Avellone

UIButton

UIButton is the generic, clickable object one expects to find on any PC game interface. It also acts as a 'restricted' container of sorts, as it can contain specific UI objects within it.   A button is made up of several child objects contained in a single pane. These pieces can be defined explicitly or left up to the engine to define.   The child objects that a UIButton can contain are: Up to 1 UIText field. If a UIText object is not defined as a child object in the XML, the engine will

Rob McGinnis

Rob McGinnis

2DA Caching for Script Lookups

(Rich Taylor gives us a peek into 2da caching)   Our lead scripter, Charles Mead, informed me that we did not cache 2DAs that were being queried by script. This resulted in ridiculous seek time for looping over large 2DAs.   He indicated that Bioware had fixed that in the 1.64 code, so I referenced the 1.67 code drop that we had and saw that they had implemented a system whereby the most recent 2 2DAs that were queried were cached.   I took that a bit further and made it so that the # o

Rob McGinnis

Rob McGinnis

UIText

UIText is the GUI object used for containing and rendering text. It is one of the more complicated UI Objects to work with.   UIText takes the following attributes:   fontfamily This defines which font should be used via a string argument. The fonts are defined in fontfamily.xml. The 'name' attribute for the different UIFontFamily elements in fontfamily.xml is how they are identified here. If this attribute is not set, then the text field will use the 'Default' font family defined in fon

Rob McGinnis

Rob McGinnis

UIFrame

By: Rich Taylor   UI Frame is used for borders and backgrounds for other UI Objects. UIFrames are imbedded in buttons and a few of the container style UI Objects that will be discussed later.   The following attributes are handled by UIFrame:   The following is a list of the texture pieces that make up a frame. They take a texture name as an argument. The texture pieces are: topleft, topright, top, left, right, bottom, bottomleft, bottomright, fill.   The next set of attributes are

Rob McGinnis

Rob McGinnis

UIObject - hideoverride

By: Rich Taylor   In 1.05 there is a new attribute that all UI Objects handle called hideoverride. If true, this attribute sets a UI Object hidden and keeps it that way until a script says otherwise via the SetGuiObjectHidden() script function.   This can be used to keep an item hidden that the GUI may try to make visible regardless what a script tries to do, such as a row in a list box.   As a result, objects that are set hidden via SetGuiObjectHidden() will STAY hidden no matter what,

Rob McGinnis

Rob McGinnis

Three-part Question on adding feats

Q: Trying to modify the knockdown feat in the feats.2da and here's what I've found. There is both a Cooldown time and also a Uses per day.   Cooldown If I set a cooldown time it "works", in a sense you can only use the kd feat every X seconds (whatever you set it as) - but the problem with this, is that it doesn't give any graphical feed back to the users (for example, Rage shows a "greyed out" icon and how long you have to wait till you can reuse it again - if I modify the kd feat it d

Rob McGinnis

Rob McGinnis

8-bit Alpha and Translucent Surfaces

Q: With 8-bit alpha, is it possible with the current NWN2 engine to use the alpha to make a surface translucent (as in 50% opacity with an alpha pixel value of 50%)?   A: There are two ways to make a surface translucent.   One way would be to make a special effect that edits the alpha. In the VFX editor this would be called a "game model effect". Then you'd have to assign the effect to the object via the toolset, or script.   The second way would be to export the model that you want the

Rob McGinnis

Rob McGinnis

Special Screens

By: Rich Taylor   Taking a break from writing about the UI Elements for a moment, though there are still some of those that I will cover in future posts.   Most XML files are loaded as default UI Scene, which implies no special behaviors. There are, however, several XML files that will get special handling in code and most conform to specific rules in order to even be loaded. All of these scenes are distinguished by their identifying name in the INI file (Or the screen tag given to them wh

Rob McGinnis

Rob McGinnis

UIObject

UIObject is the 'base' GUI object. You can't actually define it in XML, but it contains attributes that are common to many different UI Objects, so I'm starting here.   The following are the attributes that will be loaded for every UI Object in the XML file except for the attributes.   Some attributes will be ignored or overridden depending on the situation. Note that attributes are case sensitive.   name String value for the name of the UI Object. This is used internally and will be

Rob McGinnis

Rob McGinnis

rpg mechanics 'n stuff

I have written before about the strange position occupied by RPGs in modern computer gaming (PC or otherwise). In summary: tabletop RPGs and most of their CRPG kin were born out of mechanics necessitated by the realities of playing a game with dice, paper, and pencils. Everything was either uncontested expression on behalf of the player or a simulated contest governed by probability. Modern PCs and consoles can now, with a fair amount of accuracy, simulate movement, lighting, perception, and vir

J.E. Sawyer

J.E. Sawyer

UIPane

UIPane is the generic 'container' for other UI Objects. Panes can't be rendered, but they can contain 'child' objects which can be renderable objects.   Every scene has a 'rootpane', which is automatically defined by the engine when a new UIScene is loaded from a XML file.   Child objects within a pane will be positioned with their x,y origin relative to the origin of the UI Pane that contains the child. UIPanes can also simulate buttons with the tupple attribute, so many of the attributes

Rob McGinnis

Rob McGinnis

Upcoming 1.05 Patch

Rich Taylor gives us a peek into what will be in the 1.05 patch:   While the 1.04 patch is about to come out for NWN2, the 1.05 patch isn't too far off either. Rather than make 1.05 a big patch like 1.04 is, we want to release a small, quick patch to try and quickly resolve some issues the custom content community for NWN2 is running into.   I recently revamped the auto-updater to allow for incremental patches. This means that if someone had 1.02, the patcher would patch them up to 1.03, t

Rob McGinnis

Rob McGinnis

UIScene

The UIScene tag at the top of the XML files defines certain global parameters about the entire GUI window being defined in the file.   A scene doesn't have anything to render by default, but rather contains items that will get rendered. So a file that defines a UIScene and nothing else will not appear as anything in the game.   Some of the attributes for UIScene overlap with those of UIObject, even though UIScene does not inherit from UIObject, so this attributes will be repeated here.  

Rob McGinnis

Rob McGinnis

MDB File Bitflags

Q: Some of the blocks in a MDB file have a 32-bit field in front of the vertex count field, which we assume is a flag bit vector. In most cases it has a value of 0, but occasionally some bits are set. What do they indicate?   A: The bitflags are as follows for skin and rigid packets:   const DWORD NWN2_ALPHA_TEST = 1 << 0; const DWORD NWN2_ALPHA_BLEND = 1 << 1; // #### SHOULD NOT BE USED const DWORD NWN2_ADDITIVE_BLEND = 1 << 2; // #### SHOULD NOT BE USED const DWOR

Rob McGinnis

Rob McGinnis

Ranges.2da and Seeing Stars

Q: Ranges.2da has 2 columns labeled 'PrimaryRange' and 'SecondaryRange' which are apparently only used for perception ranges... Which of these columns affects the seeing range and which hearing (I assume 'Primary' is hearing based on my tests, but I'm not sure)? What values does the PercepRngDefault use? It uses the usual **** entries for default values, but where is that value defined?   A: Primary Range is the Spot range (Visual range) Secondary Range is the Listen range (Hearing range)

Rob McGinnis

Rob McGinnis

Alpha Transparencies in Foliage

Q: Currently I am working on a community download pack containg a large variety of foilage placeables (ferns, shrubs, weeds, flowers, small trees etc.). I am using alpha layers in my textures, and currently have tried dxt5 interpolated alpha (this is what format I use for my foilage in other engines such as UT2003/4) and also dxt1 with alpha, but I get no transparency in the toolset. My models and textures are showing up in the toolset just fine, but the engine seems to ignore the alpha on my d

Rob McGinnis

Rob McGinnis

×
×
  • Create New...