For a quick start you can just use the predefined pictures included in the ButtonFace Library: 

To create such a pictural push button within an application all you need to do is to call one of the new convenience functions: 

• XmCreateStandardPushButton(Parent, Name, FaceType, Args, ArgCount)
• XmCreateStandardPushButtonGadget(...)
• XmCreatePixmapPushButton(Parent, Name, Normal, Armed, Insensitive, Args, ArgCount)
• XmCreatePixmapPushButtonGadget(...)

• XmCreateStandardLabel(Parent, Name, FaceType, Args, ArgCount)
• XmCreateStandardLabelGadget(...)
• XmCreatePixmapLabel(Parent, Name, Normal, Insensitive, Args, ArgCount)
• XmCreatePixmapLabelGadget(...)

To provide a consistent look-and-feel the ButtonFace Library also features new message dialogs which behave much like the ones known from Motif. This time the new dialogs use pictural push buttons and display much nicer icons to indicate the sort of message (warning, error,...). In addition you may also create the message dialog and get the user's answer with just one line of code with the help of a new convenience function. Here is just one example. The following line of code creates a message dialog, waits for the user's response and finaly returns it: 

 answer = XmMessageBox(w, "Quit...",
 "Do you really want to quit?",
 MB_YESNO | MB_DEFAULT2, NULL);

Moreover the ButtonFace Library eases the process of localizing an application: you can specify the push button's pixmaps in resource files. This enables you to switch to another language with no pain. 

But what do I need to use the ButtonFace Library? 

• Motif at least. This should be Motif 1.1 or 1.2 but since the ButtonFace Library only uses documented calls it should also work seamless with the upcomming Motif 2.0 (if it ever comes...)
• The Xpm package ready installed. If you just don't have one ready at hand, here is it! (Beware: this is a link to the ftp server of the X Organisation in the USA.)
• An ANSI C compliant compiler: gcc for example.
• (some) artistic skills will help very much when crafting the pixmaps to be used with your own pictural push buttons.