1
0
mirror of https://github.com/fadden/6502bench.git synced 2024-11-30 01:50:10 +00:00
6502bench/SourceGen/WpfGui/FormatAddressTable.xaml.cs
Andy McFadden d3670c48e8 Label rework, part 6
Correct handling of local variables.  We now correctly uniquify them
with regard to non-unique labels.  Because local vars can effectively
have global scope we mostly want to treat them as global, but they're
uniquified relative to other globals very late in the process, so we
can't just throw them in the symbol table and be done.  Fortunately
local variables exist in a separate namespace, so we just need to
uniquify the variables relative to the post-localization symbol table.
In other words, we take the symbol table, apply the label map, and
rename any variable that clashes.

This also fixes an older problem where we weren't masking the
leading '_' on variable labels when generating 64tass output.

The code list now makes non-unique labels obvious, but you can't tell
the difference between unique global and unique local.  What's more,
the default type value in Edit Label is now adjusted to Global for
unique locals that were auto-generated.  To make it a bit easier to
figure out what's what, the Info panel now has a "label type" line
that reports the type.

The 2023-non-unique-labels test had some additional tests added to
exercise conflicts with local variables.  The 2019-local-variables
test output changed slightly because the de-duplicated variable
naming convention was simplified.
2019-11-18 13:36:53 -08:00

556 lines
22 KiB
C#

/*
* Copyright 2019 faddenSoft
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.ComponentModel;
using System.Diagnostics;
using System.Runtime.CompilerServices;
using System.Windows;
using System.Windows.Controls;
using Asm65;
using CommonUtil;
namespace SourceGen.WpfGui {
/// <summary>
/// Split-address table generator.
/// </summary>
public partial class FormatAddressTable : Window, INotifyPropertyChanged {
/// Format descriptors to apply.
/// </summary>
public SortedList<int, FormatDescriptor> NewFormatDescriptors { get; private set; }
/// <summary>
/// User labels to apply.
/// </summary>
public Dictionary<int, Symbol> NewUserLabels { get; private set; }
/// <summary>
/// All target offsets found. The list may contain redundant entries.
/// </summary>
public List<int> AllTargetOffsets { get; private set; }
/// <summary>
/// If set, targets are offset by one for RTS/RTL.
/// </summary>
public bool IsAdjustedForReturn {
get { return mIsAdjustedForReturn; }
set { mIsAdjustedForReturn = value; OnPropertyChanged(); UpdateControls(); }
}
private bool mIsAdjustedForReturn;
/// <summary>
/// If set, this is a split-address table, e.g. all of the low bytes are followed
/// by all of the high bytes.
/// </summary>
public bool IsSplitTable {
get { return mIsSplitTable; }
set { mIsSplitTable = value; OnPropertyChanged(); UpdateControls(); }
}
private bool mIsSplitTable;
/// <summary>
/// If set, caller will add code entry hints to targets.
/// </summary>
public bool WantCodeHints {
get { return mWantCodeHints; }
set {
mWantCodeHints = value;
OnPropertyChanged();
}
}
private bool mWantCodeHints;
/// <summary>
/// Set to true to make the "incompatible with selection" message visible.
/// </summary>
public bool IncompatibleSelectionVisibility {
get { return mIncompatibleSelectionVisibility; }
set {
mIncompatibleSelectionVisibility = value;
OnPropertyChanged();
}
}
private bool mIncompatibleSelectionVisibility;
/// <summary>
/// Set to true to make the "invalid constant" message visible.
/// </summary>
public bool InvalidConstantVisibility {
get { return mInvalidConstantVisibility; }
set {
mInvalidConstantVisibility = value;
OnPropertyChanged();
}
}
private bool mInvalidConstantVisibility;
/// <summary>
/// Set to true when valid output is available.
/// </summary>
private bool mOutputReady;
/// <summary>
/// Set to true when input is valid. Controls whether the OK button is enabled.
/// </summary>
public bool IsValid {
get { return mIsValid; }
set { mIsValid = value; OnPropertyChanged(); }
}
private bool mIsValid;
public class OutputPreviewItem {
public string Addr { get; private set; }
public string Offset { get; private set; }
public string Symbol { get; private set; }
public OutputPreviewItem(string addr, string offset, string symbol) {
Addr = addr;
Offset = offset;
Symbol = symbol;
}
}
public ObservableCollection<OutputPreviewItem> OutputPreviewList { get; private set; }
/// <summary>
/// Selected offsets. An otherwise contiguous range of offsets can be broken up
/// by user-specified labels and address discontinuities, so this needs to be
/// processed by range.
/// </summary>
private TypedRangeSet mSelection;
/// <summary>
/// Project reference.
/// </summary>
private DisasmProject mProject;
/// <summary>
/// Formatter to use when displaying addresses and hex values.
/// </summary>
private Formatter mFormatter;
/// <summary>
/// Reentrancy block for UpdateControls().
/// </summary>
private bool mUpdating;
// INotifyPropertyChanged implementation
public event PropertyChangedEventHandler PropertyChanged;
private void OnPropertyChanged([CallerMemberName] string propertyName = "") {
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
}
public FormatAddressTable(Window owner, DisasmProject project, TypedRangeSet selection,
Formatter formatter) {
InitializeComponent();
Owner = owner;
DataContext = this;
mProject = project;
mFormatter = formatter;
mSelection = selection;
IsValid = false;
OutputPreviewList = new ObservableCollection<OutputPreviewItem>();
}
private void Window_Loaded(object sender, RoutedEventArgs e) {
mUpdating = true;
string fmt, infoStr;
if (mSelection.RangeCount == 1 && mSelection.Count == 1) {
infoStr = (string)FindResource("str_SingleByte");
} else if (mSelection.RangeCount == 1) {
fmt = (string)FindResource("str_SingleGroup");
infoStr = string.Format(fmt, mSelection.Count);
} else {
fmt = (string)FindResource("str_MultiGroup");
infoStr = string.Format(fmt, mSelection.Count, mSelection.RangeCount);
}
selectionInfoLabel.Text = infoStr;
width16Radio.IsChecked = true;
lowFirstPartRadio.IsChecked = true;
highSecondPartRadio.IsChecked = true;
bankNthPartRadio.IsChecked = true;
IncompatibleSelectionVisibility = InvalidConstantVisibility = false;
if (mProject.CpuDef.HasAddr16) {
// Disable the 24-bit option. Having 16-bit selected will disable the rest.
width24Radio.IsEnabled = false;
}
mUpdating = false;
UpdateControls();
}
private void OkButton_Click(object sender, RoutedEventArgs e) {
DialogResult = true;
}
private void UpdateControls() {
if (mUpdating) {
return;
}
mUpdating = true; // no re-entry
// handled with XAML bindings
//lowThirdPartRadio.Enabled = width24Radio.Checked;
//highThirdPartRadio.Enabled = width24Radio.Checked;
//bankByteGroupBox.Enabled = width24Radio.Checked;
lowSecondPartRadio.IsEnabled = true;
// If the user selects "constant" for high byte or bank byte, then there is no
// 3rd part available for low/high, so we need to turn those back off.
if (width24Radio.IsChecked == true) {
bool haveThree = !(highConstantRadio.IsChecked == true ||
bankConstantRadio.IsChecked == true);
lowThirdPartRadio.IsEnabled = haveThree;
highThirdPartRadio.IsEnabled = haveThree;
// If "constant" is selected for high byte *and* bank byte, then there's no
// 2nd part available for low.
if (highConstantRadio.IsChecked == true && bankConstantRadio.IsChecked == true) {
lowSecondPartRadio.IsEnabled = false;
}
} else {
// For 16-bit address, if high byte is constant, then there's no second
// part for the low byte.
if (highConstantRadio.IsChecked == true) {
lowSecondPartRadio.IsEnabled = false;
}
}
// Was a now-invalidated radio button selected before?
if (!lowThirdPartRadio.IsEnabled && lowThirdPartRadio.IsChecked == true) {
// low now invalid, switch to whatever high isn't using
if (highFirstPartRadio.IsChecked == true) {
lowSecondPartRadio.IsChecked = true;
} else {
lowFirstPartRadio.IsChecked = true;
}
}
if (width16Radio.IsChecked == true && highThirdPartRadio.IsChecked == true) {
// high now invalid, switch to whatever low isn't using
if (lowFirstPartRadio.IsChecked == true) {
highSecondPartRadio.IsChecked = true;
} else {
highFirstPartRadio.IsChecked = true;
}
}
if (!lowSecondPartRadio.IsEnabled && lowSecondPartRadio.IsChecked == true) {
// Should only happen when high part is constant.
Debug.Assert(highFirstPartRadio.IsChecked == false);
lowFirstPartRadio.IsChecked = true;
}
mUpdating = false;
UpdatePreview();
IsValid = mOutputReady;
}
private void WidthRadio_CheckedChanged(object sender, RoutedEventArgs e) {
UpdateControls();
}
private void LowByte_CheckedChanged(object sender, RoutedEventArgs e) {
// If we conflict with the high byte, change the high byte.
if (lowFirstPartRadio.IsChecked == true && highFirstPartRadio.IsChecked == true) {
highSecondPartRadio.IsChecked = true;
} else if (lowSecondPartRadio.IsChecked == true && highSecondPartRadio.IsChecked == true) {
highFirstPartRadio.IsChecked = true;
} else if (lowThirdPartRadio.IsChecked == true && highThirdPartRadio.IsChecked == true) {
highFirstPartRadio.IsChecked = true;
}
UpdateControls();
}
private void HighByte_CheckedChanged(object sender, RoutedEventArgs e) {
// If we conflict with the low byte, change the low byte.
if (lowFirstPartRadio.IsChecked == true && highFirstPartRadio.IsChecked == true) {
lowSecondPartRadio.IsChecked = true;
} else if (lowSecondPartRadio.IsChecked == true && highSecondPartRadio.IsChecked == true) {
lowFirstPartRadio.IsChecked = true;
} else if (lowThirdPartRadio.IsChecked == true && highThirdPartRadio.IsChecked == true) {
lowFirstPartRadio.IsChecked = true;
}
UpdateControls();
}
private void BankByte_CheckedChanged(object sender, EventArgs e) {
UpdateControls();
}
private void HighConstantTextBox_TextChanged(object sender, TextChangedEventArgs e) {
highConstantRadio.IsChecked = true;
UpdateControls();
}
private void BankConstantTextBox_TextChanged(object sender, TextChangedEventArgs e) {
bankConstantRadio.IsChecked = true;
UpdateControls();
}
private void UpdatePreview() {
mOutputReady = false;
int minDiv;
if (width16Radio.IsChecked == true) {
if (highConstantRadio.IsChecked == true) {
minDiv = 1;
} else {
minDiv = 2;
}
} else {
if (highConstantRadio.IsChecked == true) {
if (bankConstantRadio.IsChecked == true) {
minDiv = 1;
} else {
minDiv = 2;
}
} else {
if (bankConstantRadio.IsChecked == true) {
minDiv = 2;
} else {
minDiv = 3;
}
}
}
IncompatibleSelectionVisibility = InvalidConstantVisibility = false;
// Start by clearing the previous contents of the list. If something goes
// wrong, we want to show the error messages on an empty list.
OutputPreviewList.Clear();
if ((mSelection.Count % minDiv) != 0) {
IncompatibleSelectionVisibility = true;
return;
}
int highConstant = -1;
if (highConstantRadio.IsChecked == true) {
if (!Number.TryParseInt(highConstantTextBox.Text, out highConstant,
out int unused) || (highConstant != (byte) highConstant)) {
InvalidConstantVisibility = true;
return;
}
}
int bankConstant = -1;
if (bankConstantRadio.IsEnabled && bankConstantRadio.IsChecked == true) {
if (!Number.TryParseInt(bankConstantTextBox.Text, out bankConstant,
out int unused) || (bankConstant != (byte) bankConstant)) {
InvalidConstantVisibility = true;
return;
}
}
// Looks valid, generate format list.
GenerateFormats(minDiv, highConstant, bankConstant);
}
private void GenerateFormats(int div, int highConst, int bankConst) {
SortedList<int, FormatDescriptor> newDfds = new SortedList<int, FormatDescriptor>();
Dictionary<int, Symbol> newLabels = new Dictionary<int, Symbol>();
List<int> targetOffsets = new List<int>();
bool isBigEndian;
// Identify the offset where each set of data starts.
int span = mSelection.Count / div;
int lowOff, highOff, bankOff;
int stride;
if (lowFirstPartRadio.IsChecked == true) {
lowOff = 0;
isBigEndian = false;
} else if (lowSecondPartRadio.IsChecked == true) {
lowOff = 1;
isBigEndian = true;
} else if (lowThirdPartRadio.IsChecked == true) {
lowOff = 2;
isBigEndian = true;
} else {
Debug.Assert(false);
lowOff = -1;
isBigEndian = false;
}
if (highFirstPartRadio.IsChecked == true) {
highOff = 0;
} else if (highSecondPartRadio.IsChecked == true) {
highOff = 1;
} else if (highThirdPartRadio.IsChecked == true) {
highOff = 2;
} else {
highOff = -1; // use constant
}
if (width24Radio.IsChecked == true) {
if (bankNthPartRadio.IsChecked == true) {
// Use whichever part isn't being used by the other two.
if (lowOff != 0 && highOff != 0) {
bankOff = 0;
} else if (lowOff != 1 && highOff != 1) {
bankOff = 1;
} else {
Debug.Assert(lowOff != 2 && highOff != 2);
bankOff = 2;
}
} else {
bankOff = -1; // use constant
}
} else {
bankOff = -1; // use constant
bankConst = 0; // always bank 0
}
if (IsSplitTable) {
// Split table, so stride is 1 and each section start is determined by the span.
stride = 1;
lowOff *= span;
highOff *= span;
bankOff *= span;
} else {
// For non-split table, the stride is the width of each entry.
stride = 1;
if (highOff >= 0) {
stride++;
}
if (bankOff >= 0) {
stride++;
}
}
Debug.WriteLine("FormatAddressTable: stride=" + stride + " span=" + span +
" count=" + mSelection.Count);
Debug.WriteLine(" low=" + lowOff + " high=" + highOff + " bank=" + bankOff);
// The TypedRangeSet doesn't have an index operation, so copy the values into
// an array.
int[] offsets = new int[mSelection.Count];
int index = 0;
foreach (TypedRangeSet.Tuple tup in mSelection) {
offsets[index++] = tup.Value;
}
int adj = 0;
if (IsAdjustedForReturn) {
adj = 1;
}
// Walk through the file data, generating addresses as we go.
byte[] fileData = mProject.FileData;
for (int i = 0; i < span; i++) {
byte low, high, bank;
low = fileData[offsets[lowOff + i * stride]];
if (highOff >= 0) {
high = fileData[offsets[highOff + i * stride]];
} else {
high = (byte) highConst;
}
if (bankOff >= 0) {
bank = fileData[offsets[bankOff + i * stride]];
} else {
bank = (byte) bankConst;
}
int addr = ((bank << 16) | (high << 8) | low) + adj;
int targetOffset = mProject.AddrMap.AddressToOffset(offsets[0], addr);
if (targetOffset < 0) {
// Address not within file bounds.
// TODO(maybe): look for matching platform/project symbols
AddPreviewItem(addr, -1, Res.Strings.INVALID_ADDRESS);
} else {
// Note the same target offset may appear more than once.
targetOffsets.Add(targetOffset);
// If there's a user-defined label there already, use it. Otherwise, we'll
// need to generate one.
string targetLabel;
if (mProject.UserLabels.TryGetValue(targetOffset, out Symbol sym)) {
targetLabel = sym.Label;
AddPreviewItem(addr, targetOffset, targetLabel);
} else {
// Generate a symbol that's unique vs. the symbol table. We don't need
// it to be unique vs. the labels we're generating here, because we
// won't generate identical labels for different addresses, and we do
// want to generate a single label if more than one table entry refers
// to the same target.
Symbol tmpSym = AutoLabel.GenerateUniqueForAddress(addr,
mProject.SymbolTable, "T");
// tmpSym was returned as an auto-label, make it a user label instead
// (with global scope)
tmpSym = new Symbol(tmpSym.Label, tmpSym.Value, Symbol.Source.User,
Symbol.Type.GlobalAddr, Symbol.LabelAnnotation.Generated);
newLabels[targetOffset] = tmpSym; // overwrites previous
targetLabel = tmpSym.Label;
AddPreviewItem(addr, targetOffset, "(+) " + targetLabel);
}
if (IsSplitTable) {
// Now we need to create format descriptors for the addresses where we
// extracted the low, high, and bank values.
newDfds.Add(offsets[lowOff + i * stride], FormatDescriptor.Create(1,
new WeakSymbolRef(targetLabel, WeakSymbolRef.Part.Low), false));
if (highOff >= 0) {
newDfds.Add(offsets[highOff + i * stride], FormatDescriptor.Create(1,
new WeakSymbolRef(targetLabel, WeakSymbolRef.Part.High), false));
}
if (bankOff >= 0) {
newDfds.Add(offsets[bankOff + i * stride], FormatDescriptor.Create(1,
new WeakSymbolRef(targetLabel, WeakSymbolRef.Part.Bank), false));
}
} else {
// Create a single format descriptor that spans all bytes. Note we
// don't want to use lowOff here -- we want to put the format on
// whichever byte came first.
// TODO(maybe): we don't correctly deal with a "scrambled" non-split
// 24-bit table, i.e. low then bank then high. This is not really
// a thing, but we should either prevent it or punt to single-byte
// like we do for split tables.
Debug.Assert(stride >= 1 && stride <= 3);
newDfds.Add(offsets[0 + i * stride], FormatDescriptor.Create(stride,
new WeakSymbolRef(targetLabel, WeakSymbolRef.Part.Low), isBigEndian));
}
}
}
NewFormatDescriptors = newDfds;
NewUserLabels = newLabels;
AllTargetOffsets = targetOffsets;
// Don't show ready if all addresses are invalid. It's okay if some work and
// some don't.
mOutputReady = (AllTargetOffsets.Count > 0);
}
private void AddPreviewItem(int addr, int offset, string label) {
OutputPreviewItem newItem = new OutputPreviewItem(
mFormatter.FormatAddress(addr, !mProject.CpuDef.HasAddr16),
(offset >= 0 ? mFormatter.FormatOffset24(offset) : "---"),
label);
OutputPreviewList.Add(newItem);
}
}
}