better docs
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
package screensaver
|
||||
|
||||
/*
|
||||
This file was generated by screensaver.xml on May 10 2012 8:04:32pm EDT.
|
||||
This file was generated by screensaver.xml on May 10 2012 11:56:19pm EDT.
|
||||
This file is automatically generated. Edit at your peril!
|
||||
*/
|
||||
|
||||
@@ -40,6 +40,10 @@ func init() {
|
||||
xgb.NewExtErrorFuncs["MIT-SCREEN-SAVER"] = make(map[int]xgb.NewErrorFun)
|
||||
}
|
||||
|
||||
// Skipping definition for base type 'Card32'
|
||||
|
||||
// Skipping definition for base type 'Double'
|
||||
|
||||
// Skipping definition for base type 'Bool'
|
||||
|
||||
// Skipping definition for base type 'Float'
|
||||
@@ -60,10 +64,6 @@ func init() {
|
||||
|
||||
// Skipping definition for base type 'Char'
|
||||
|
||||
// Skipping definition for base type 'Card32'
|
||||
|
||||
// Skipping definition for base type 'Double'
|
||||
|
||||
const (
|
||||
KindBlanked = 0
|
||||
KindInternal = 1
|
||||
@@ -82,9 +82,7 @@ const (
|
||||
StateDisabled = 3
|
||||
)
|
||||
|
||||
// Event definition Notify (0)
|
||||
// Size: 32
|
||||
|
||||
// Notify is the event number for a NotifyEvent.
|
||||
const Notify = 0
|
||||
|
||||
type NotifyEvent struct {
|
||||
@@ -101,7 +99,7 @@ type NotifyEvent struct {
|
||||
// padding: 14 bytes
|
||||
}
|
||||
|
||||
// Event read Notify
|
||||
// NotifyEventNew constructs a NotifyEvent value that implements xgb.Event from a byte slice.
|
||||
func NotifyEventNew(buf []byte) xgb.Event {
|
||||
v := NotifyEvent{}
|
||||
b := 1 // don't read event number
|
||||
@@ -144,7 +142,7 @@ func NotifyEventNew(buf []byte) xgb.Event {
|
||||
return v
|
||||
}
|
||||
|
||||
// Event write Notify
|
||||
// Bytes writes a NotifyEvent value to a byte slice.
|
||||
func (v NotifyEvent) Bytes() []byte {
|
||||
buf := make([]byte, 32)
|
||||
b := 0
|
||||
@@ -190,12 +188,14 @@ func (v NotifyEvent) Bytes() []byte {
|
||||
return buf
|
||||
}
|
||||
|
||||
func (v NotifyEvent) ImplementsEvent() {}
|
||||
|
||||
// SequenceId returns the sequence id attached to the Notify event.
|
||||
// Events without a sequence number (KeymapNotify) return 0.
|
||||
// This is mostly used internally.
|
||||
func (v NotifyEvent) SequenceId() uint16 {
|
||||
return v.Sequence
|
||||
}
|
||||
|
||||
// String is a rudimentary string representation of NotifyEvent.
|
||||
func (v NotifyEvent) String() string {
|
||||
fieldVals := make([]string, 0, 10)
|
||||
fieldVals = append(fieldVals, xgb.Sprintf("Sequence: %d", v.Sequence))
|
||||
@@ -214,36 +214,38 @@ func init() {
|
||||
xgb.NewExtEventFuncs["MIT-SCREEN-SAVER"][0] = NotifyEventNew
|
||||
}
|
||||
|
||||
// Request QueryVersion
|
||||
// size: 8
|
||||
// QueryVersionCookie is a cookie used only for QueryVersion requests.
|
||||
type QueryVersionCookie struct {
|
||||
*xgb.Cookie
|
||||
}
|
||||
|
||||
// QueryVersion sends a checked request.
|
||||
// If an error occurs, it will be returned with the reply by calling QueryVersionCookie.Reply()
|
||||
func QueryVersion(c *xgb.Conn, ClientMajorVersion byte, ClientMinorVersion byte) QueryVersionCookie {
|
||||
cookie := c.NewCookie(true, true)
|
||||
c.NewRequest(queryVersionRequest(c, ClientMajorVersion, ClientMinorVersion), cookie)
|
||||
return QueryVersionCookie{cookie}
|
||||
}
|
||||
|
||||
// QueryVersionUnchecked sends an unchecked request.
|
||||
// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
|
||||
func QueryVersionUnchecked(c *xgb.Conn, ClientMajorVersion byte, ClientMinorVersion byte) QueryVersionCookie {
|
||||
cookie := c.NewCookie(false, true)
|
||||
c.NewRequest(queryVersionRequest(c, ClientMajorVersion, ClientMinorVersion), cookie)
|
||||
return QueryVersionCookie{cookie}
|
||||
}
|
||||
|
||||
// Request reply for QueryVersion
|
||||
// size: 32
|
||||
// QueryVersionReply represents the data returned from a QueryVersion request.
|
||||
type QueryVersionReply struct {
|
||||
Sequence uint16
|
||||
Length uint32
|
||||
Sequence uint16 // sequence number of the request for this reply
|
||||
Length uint32 // number of bytes in this reply
|
||||
// padding: 1 bytes
|
||||
ServerMajorVersion uint16
|
||||
ServerMinorVersion uint16
|
||||
// padding: 20 bytes
|
||||
}
|
||||
|
||||
// Waits and reads reply data from request QueryVersion
|
||||
// Reply blocks and returns the reply data for a QueryVersion request.
|
||||
func (cook QueryVersionCookie) Reply() (*QueryVersionReply, error) {
|
||||
buf, err := cook.Cookie.Reply()
|
||||
if err != nil {
|
||||
@@ -255,7 +257,7 @@ func (cook QueryVersionCookie) Reply() (*QueryVersionReply, error) {
|
||||
return queryVersionReply(buf), nil
|
||||
}
|
||||
|
||||
// Read reply into structure from buffer for QueryVersion
|
||||
// queryVersionReply reads a byte slice into a QueryVersionReply value.
|
||||
func queryVersionReply(buf []byte) *QueryVersionReply {
|
||||
v := new(QueryVersionReply)
|
||||
b := 1 // skip reply determinant
|
||||
@@ -280,6 +282,7 @@ func queryVersionReply(buf []byte) *QueryVersionReply {
|
||||
}
|
||||
|
||||
// Write request to wire for QueryVersion
|
||||
// queryVersionRequest writes a QueryVersion request to a byte slice.
|
||||
func queryVersionRequest(c *xgb.Conn, ClientMajorVersion byte, ClientMinorVersion byte) []byte {
|
||||
size := 8
|
||||
b := 0
|
||||
@@ -305,29 +308,31 @@ func queryVersionRequest(c *xgb.Conn, ClientMajorVersion byte, ClientMinorVersio
|
||||
return buf
|
||||
}
|
||||
|
||||
// Request QueryInfo
|
||||
// size: 8
|
||||
// QueryInfoCookie is a cookie used only for QueryInfo requests.
|
||||
type QueryInfoCookie struct {
|
||||
*xgb.Cookie
|
||||
}
|
||||
|
||||
// QueryInfo sends a checked request.
|
||||
// If an error occurs, it will be returned with the reply by calling QueryInfoCookie.Reply()
|
||||
func QueryInfo(c *xgb.Conn, Drawable xproto.Drawable) QueryInfoCookie {
|
||||
cookie := c.NewCookie(true, true)
|
||||
c.NewRequest(queryInfoRequest(c, Drawable), cookie)
|
||||
return QueryInfoCookie{cookie}
|
||||
}
|
||||
|
||||
// QueryInfoUnchecked sends an unchecked request.
|
||||
// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
|
||||
func QueryInfoUnchecked(c *xgb.Conn, Drawable xproto.Drawable) QueryInfoCookie {
|
||||
cookie := c.NewCookie(false, true)
|
||||
c.NewRequest(queryInfoRequest(c, Drawable), cookie)
|
||||
return QueryInfoCookie{cookie}
|
||||
}
|
||||
|
||||
// Request reply for QueryInfo
|
||||
// size: 32
|
||||
// QueryInfoReply represents the data returned from a QueryInfo request.
|
||||
type QueryInfoReply struct {
|
||||
Sequence uint16
|
||||
Length uint32
|
||||
Sequence uint16 // sequence number of the request for this reply
|
||||
Length uint32 // number of bytes in this reply
|
||||
State byte
|
||||
SaverWindow xproto.Window
|
||||
MsUntilServer uint32
|
||||
@@ -337,7 +342,7 @@ type QueryInfoReply struct {
|
||||
// padding: 7 bytes
|
||||
}
|
||||
|
||||
// Waits and reads reply data from request QueryInfo
|
||||
// Reply blocks and returns the reply data for a QueryInfo request.
|
||||
func (cook QueryInfoCookie) Reply() (*QueryInfoReply, error) {
|
||||
buf, err := cook.Cookie.Reply()
|
||||
if err != nil {
|
||||
@@ -349,7 +354,7 @@ func (cook QueryInfoCookie) Reply() (*QueryInfoReply, error) {
|
||||
return queryInfoReply(buf), nil
|
||||
}
|
||||
|
||||
// Read reply into structure from buffer for QueryInfo
|
||||
// queryInfoReply reads a byte slice into a QueryInfoReply value.
|
||||
func queryInfoReply(buf []byte) *QueryInfoReply {
|
||||
v := new(QueryInfoReply)
|
||||
b := 1 // skip reply determinant
|
||||
@@ -384,6 +389,7 @@ func queryInfoReply(buf []byte) *QueryInfoReply {
|
||||
}
|
||||
|
||||
// Write request to wire for QueryInfo
|
||||
// queryInfoRequest writes a QueryInfo request to a byte slice.
|
||||
func queryInfoRequest(c *xgb.Conn, Drawable xproto.Drawable) []byte {
|
||||
size := 8
|
||||
b := 0
|
||||
@@ -404,30 +410,35 @@ func queryInfoRequest(c *xgb.Conn, Drawable xproto.Drawable) []byte {
|
||||
return buf
|
||||
}
|
||||
|
||||
// Request SelectInput
|
||||
// size: 12
|
||||
// SelectInputCookie is a cookie used only for SelectInput requests.
|
||||
type SelectInputCookie struct {
|
||||
*xgb.Cookie
|
||||
}
|
||||
|
||||
// Write request to wire for SelectInput
|
||||
// SelectInput sends an unchecked request.
|
||||
// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
|
||||
func SelectInput(c *xgb.Conn, Drawable xproto.Drawable, EventMask uint32) SelectInputCookie {
|
||||
cookie := c.NewCookie(false, false)
|
||||
c.NewRequest(selectInputRequest(c, Drawable, EventMask), cookie)
|
||||
return SelectInputCookie{cookie}
|
||||
}
|
||||
|
||||
// SelectInputChecked sends a checked request.
|
||||
// If an error occurs, it can be retrieved using SelectInputCookie.Check()
|
||||
func SelectInputChecked(c *xgb.Conn, Drawable xproto.Drawable, EventMask uint32) SelectInputCookie {
|
||||
cookie := c.NewCookie(true, false)
|
||||
c.NewRequest(selectInputRequest(c, Drawable, EventMask), cookie)
|
||||
return SelectInputCookie{cookie}
|
||||
}
|
||||
|
||||
// Check returns an error if one occurred for checked requests that are not expecting a reply.
|
||||
// This cannot be called for requests expecting a reply, nor for unchecked requests.
|
||||
func (cook SelectInputCookie) Check() error {
|
||||
return cook.Cookie.Check()
|
||||
}
|
||||
|
||||
// Write request to wire for SelectInput
|
||||
// selectInputRequest writes a SelectInput request to a byte slice.
|
||||
func selectInputRequest(c *xgb.Conn, Drawable xproto.Drawable, EventMask uint32) []byte {
|
||||
size := 12
|
||||
b := 0
|
||||
@@ -451,30 +462,35 @@ func selectInputRequest(c *xgb.Conn, Drawable xproto.Drawable, EventMask uint32)
|
||||
return buf
|
||||
}
|
||||
|
||||
// Request SetAttributes
|
||||
// size: xgb.Pad((24 + (4 + xgb.Pad((4 * xgb.PopCount(int(ValueMask)))))))
|
||||
// SetAttributesCookie is a cookie used only for SetAttributes requests.
|
||||
type SetAttributesCookie struct {
|
||||
*xgb.Cookie
|
||||
}
|
||||
|
||||
// Write request to wire for SetAttributes
|
||||
// SetAttributes sends an unchecked request.
|
||||
// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
|
||||
func SetAttributes(c *xgb.Conn, Drawable xproto.Drawable, X int16, Y int16, Width uint16, Height uint16, BorderWidth uint16, Class byte, Depth byte, Visual xproto.Visualid, ValueMask uint32, ValueList []uint32) SetAttributesCookie {
|
||||
cookie := c.NewCookie(false, false)
|
||||
c.NewRequest(setAttributesRequest(c, Drawable, X, Y, Width, Height, BorderWidth, Class, Depth, Visual, ValueMask, ValueList), cookie)
|
||||
return SetAttributesCookie{cookie}
|
||||
}
|
||||
|
||||
// SetAttributesChecked sends a checked request.
|
||||
// If an error occurs, it can be retrieved using SetAttributesCookie.Check()
|
||||
func SetAttributesChecked(c *xgb.Conn, Drawable xproto.Drawable, X int16, Y int16, Width uint16, Height uint16, BorderWidth uint16, Class byte, Depth byte, Visual xproto.Visualid, ValueMask uint32, ValueList []uint32) SetAttributesCookie {
|
||||
cookie := c.NewCookie(true, false)
|
||||
c.NewRequest(setAttributesRequest(c, Drawable, X, Y, Width, Height, BorderWidth, Class, Depth, Visual, ValueMask, ValueList), cookie)
|
||||
return SetAttributesCookie{cookie}
|
||||
}
|
||||
|
||||
// Check returns an error if one occurred for checked requests that are not expecting a reply.
|
||||
// This cannot be called for requests expecting a reply, nor for unchecked requests.
|
||||
func (cook SetAttributesCookie) Check() error {
|
||||
return cook.Cookie.Check()
|
||||
}
|
||||
|
||||
// Write request to wire for SetAttributes
|
||||
// setAttributesRequest writes a SetAttributes request to a byte slice.
|
||||
func setAttributesRequest(c *xgb.Conn, Drawable xproto.Drawable, X int16, Y int16, Width uint16, Height uint16, BorderWidth uint16, Class byte, Depth byte, Visual xproto.Visualid, ValueMask uint32, ValueList []uint32) []byte {
|
||||
size := xgb.Pad((24 + (4 + xgb.Pad((4 * xgb.PopCount(int(ValueMask)))))))
|
||||
b := 0
|
||||
@@ -527,30 +543,35 @@ func setAttributesRequest(c *xgb.Conn, Drawable xproto.Drawable, X int16, Y int1
|
||||
return buf
|
||||
}
|
||||
|
||||
// Request UnsetAttributes
|
||||
// size: 8
|
||||
// UnsetAttributesCookie is a cookie used only for UnsetAttributes requests.
|
||||
type UnsetAttributesCookie struct {
|
||||
*xgb.Cookie
|
||||
}
|
||||
|
||||
// Write request to wire for UnsetAttributes
|
||||
// UnsetAttributes sends an unchecked request.
|
||||
// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
|
||||
func UnsetAttributes(c *xgb.Conn, Drawable xproto.Drawable) UnsetAttributesCookie {
|
||||
cookie := c.NewCookie(false, false)
|
||||
c.NewRequest(unsetAttributesRequest(c, Drawable), cookie)
|
||||
return UnsetAttributesCookie{cookie}
|
||||
}
|
||||
|
||||
// UnsetAttributesChecked sends a checked request.
|
||||
// If an error occurs, it can be retrieved using UnsetAttributesCookie.Check()
|
||||
func UnsetAttributesChecked(c *xgb.Conn, Drawable xproto.Drawable) UnsetAttributesCookie {
|
||||
cookie := c.NewCookie(true, false)
|
||||
c.NewRequest(unsetAttributesRequest(c, Drawable), cookie)
|
||||
return UnsetAttributesCookie{cookie}
|
||||
}
|
||||
|
||||
// Check returns an error if one occurred for checked requests that are not expecting a reply.
|
||||
// This cannot be called for requests expecting a reply, nor for unchecked requests.
|
||||
func (cook UnsetAttributesCookie) Check() error {
|
||||
return cook.Cookie.Check()
|
||||
}
|
||||
|
||||
// Write request to wire for UnsetAttributes
|
||||
// unsetAttributesRequest writes a UnsetAttributes request to a byte slice.
|
||||
func unsetAttributesRequest(c *xgb.Conn, Drawable xproto.Drawable) []byte {
|
||||
size := 8
|
||||
b := 0
|
||||
@@ -571,30 +592,35 @@ func unsetAttributesRequest(c *xgb.Conn, Drawable xproto.Drawable) []byte {
|
||||
return buf
|
||||
}
|
||||
|
||||
// Request Suspend
|
||||
// size: 8
|
||||
// SuspendCookie is a cookie used only for Suspend requests.
|
||||
type SuspendCookie struct {
|
||||
*xgb.Cookie
|
||||
}
|
||||
|
||||
// Write request to wire for Suspend
|
||||
// Suspend sends an unchecked request.
|
||||
// If an error occurs, it can only be retrieved using xgb.WaitForEvent or xgb.PollForEvent.
|
||||
func Suspend(c *xgb.Conn, Suspend bool) SuspendCookie {
|
||||
cookie := c.NewCookie(false, false)
|
||||
c.NewRequest(suspendRequest(c, Suspend), cookie)
|
||||
return SuspendCookie{cookie}
|
||||
}
|
||||
|
||||
// SuspendChecked sends a checked request.
|
||||
// If an error occurs, it can be retrieved using SuspendCookie.Check()
|
||||
func SuspendChecked(c *xgb.Conn, Suspend bool) SuspendCookie {
|
||||
cookie := c.NewCookie(true, false)
|
||||
c.NewRequest(suspendRequest(c, Suspend), cookie)
|
||||
return SuspendCookie{cookie}
|
||||
}
|
||||
|
||||
// Check returns an error if one occurred for checked requests that are not expecting a reply.
|
||||
// This cannot be called for requests expecting a reply, nor for unchecked requests.
|
||||
func (cook SuspendCookie) Check() error {
|
||||
return cook.Cookie.Check()
|
||||
}
|
||||
|
||||
// Write request to wire for Suspend
|
||||
// suspendRequest writes a Suspend request to a byte slice.
|
||||
func suspendRequest(c *xgb.Conn, Suspend bool) []byte {
|
||||
size := 8
|
||||
b := 0
|
||||
|
||||
Reference in New Issue
Block a user